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Mellon’s  School  of  Computer  Science,  and  then 
again  when  he  and  Jenny  were  starting  their 
consulting  business  and  writing  their  first  book  for 
O’Reilly. 


Jennifer  Greene  studied  philosophy  in 
college  but,  like  everyone  else  in  the  field,  couldn't 
find  a  job  doing  it.  Luckily,  she’s  a  great  software 
tester,  so  she  started  out  doing  it  at  an  online 
serv  ice,  and  that’s  the  first  time  she  really  got  a 
good  sense  of  what  project  management  was. 

She  moved  to  New  York  in  1 998  to  lest  software 
at  a  financial  software  company  She  managed 
a  team  of  testers  at  a  really  cool  startup  that 
did  artificial  intelligence  and  natural  language 
processing. 

Since  then,  she’s  traveled  ;tll  over  the  world  to  work 
with  different  software  teams  and  build  all  kinds  of 
cool  projects. 

She  loves  traveling,  watching  Bollywood  movies, 
reading  the  occasional  comic  book,  waiting  for 
her  Xbox  to  be  repaired,  drinking  carloads  of 
carbonated  beverages,  and  owning  a  whippet. 
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get  productive  With  C# 

Visual  Applications,  in  10  minutes  or  less 

Want  to  build  great  programs  really  fast? 

With  C#,  you’ve  got  a  powerful  programming  language  and  a  valuable  tool 

at  your  fingertips.  With  the  Visual  Studio  IDE,  you’ll  never  have  to  spend  hours 
writing  obscure  code  to  get  a  button  working  again.  Even  better,  you’ll  be  able 
to  focus  on  getting  your  work  done,  rather  than  remembering  which  method 
parameter  was  for  the  name  for  a  button,  and  which  one  was  for  its  label. 
Sound  appealing?  Turn  the  page,  and  let’s  get  programming. 
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its  all  just  code 

Under  the  Hood 

You’re  a  programmer,  not  just  an  IDE-user. 

You  can  get  a  lot  of  work  done  using  the  IDE.  But  there’s  only  so  far  it 
can  take  you.  Sure,  there  are  a  lot  of  repetitive  tasks  that  you  do  when 
you  build  an  application.  And  the  IDE  is  great  at  doing  those  things  for 
you.  But  working  with  the  IDE  is  only  the  beginning.  You  can  get  your 
programs  to  do  so  much  more — and  writing  C#  code  is  how  you  do  it. 
Once  you  get  the  hang  of  coding,  there’s  nothing  your  programs  can’t  do. 
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objects  get  oriented 

Making  Code  Make  Sense 

Every  program  you  write  solves  a  problem. 

When  you’re  building  a  program,  it’s  always  a  good  idea  to  start  by  thinking  about  what 
problem  your  program’s  supposed  to  solve.  That’s  why  objects  are  really  useful.  They 
let  you  structure  your  code  based  on  the  problem  it’s  solving,  so  that  you  can  spend  your 
time  thinking  about  the  problem  you  need  to  work  on  rather  than  getting  bogged  down  in 
the  mechanics  of  writing  code.  When  you  use  objects  right,  you  end  up  with  code  that’s 
intuitive  to  write,  and  easy  to  read  and  change. 
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Mike  can  use  objects  to  solve  his  problem 
You  use  a  class  to  build  an  object 

When  you  create  a  new  object  from  a  class, 
it’s  called  an  instance  of  that  class 

A  better  solution. . .  brought  to  you  by  objects! 

An  instance  uses  fields  to  keep  track  of  things 
Let’s  create  some  instances! 

Thanks  for  the  memory 
What’s  on  your  program’s  mind 

You  can  use  class  and  method  names  to  make  your  code  intuitive 
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Class  diagrams  help  you  organize  your  classes  so  they  make  sense 
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types  and  references 

It’s  10:00.  Do  you  know  where  your  data  is? 

Data  type,  database,  Lieutenant  Commander  Data... 

it’s  all  important  stuff.  Without  data,  your  programs  are  useless.  You 
need  information  from  your  users,  and  you  use  that  to  look  up  or  produce  new 
information,  to  give  back  to  them.  In  fact,  almost  everything  you  do  in  programming 
involves  working  with  data  in  one  way  or  another.  In  this  chapter,  you’ll  learn  the 
ins  and  outs  of  C#’s  data  types,  how  to  work  with  data  in  your  program,  and  even 
figure  out  a  few  dirty  secrets  about  objects  ( pssff ...  objects  are  data,  too). 


The  variable’s  type  determines  what  kind  of  data  it  can  store  124 

A  variable  is  like  a  data  to-go  cup  1 26 

10  pounds  of  data  in  a  5  pound  bag  127 

Even  when  a  number  is  the  right  size, 

you  can’t  just  assign  it  to  any  variable  1 28 

When  you  cast  a  value  that’s  too  big,  C#  will  adjust  it  automatically  129 
C#  does  some  casting  automatically  1 30 

When  you  call  a  method,  the  variables  must 

match  the  types  of  the  parameters  1 3 1 

Combining  =  with  an  operator  1 36 

Objects  are  variables,  too  1 37 

Refer  to  your  objects  with  reference  variables  1 38 

References  are  like  labels  for  your  object  1 39 
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A  Day  at  the  Races 

Joe,  Bob,  and  AI  love  going  to  the  track,  hut  they’re 
tired  of  losing  all  their  money.  They  need  you  to  build  a 
simulator  for  them  so  they  can  figure  out  winners  before 
they  lay  their  money  down.  And,  if  you  do  a  good  job, 
they’ll  cut  you  in  on  their  profits. 


The  Spec:  Build  a  Racetrack  Simulator  1 64 

The  Finished  Product  1 7 2 
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encapsulation 

Keep  your  privates...  private 

Ever  wished  for  a  little  more  privacy? 

Sometimes  your  objects  feel  the  same  way.  Just  like  you  don’t  want  anybody  you 
don’t  trust  reading  your  journal,  or  paging  through  your  bank  statements,  good  objects 
don’t  let  other  objects  go  poking  around  their  properties.  In  this  chapter,  you’re  going 
to  learn  about  the  power  of  encapsulation.  You’ll  make  your  object’s  data  private, 
add  methods  to  protect  how  that  data  is  accessed. 


Kathleen  is  an  event  planner  1 7 4 

What  does  the  estimator  do?  175 

Kathleen’s  Test  Drive  1 80 

Each  option  should  be  calculated  individually  182 

It’s  easy  to  accidentally  misuse  your  objects  184 
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Use  encapsulation  to  control  access  to  your  class’s  methods  and  fields  186 
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Inheritance 

Your  object’s  family  tree 

Sometimes  you  DO  want  to  be  just  like  your  parents. 

Ever  run  across  an  object  that  almost  does  exactly  what  you  want  your  object  to  do? 
Found  yourself  wishing  that  if  you  could  just  change  a  few  things,  that  object  would 
be  perfect?  Well  that’s  just  one  reason  that  inheritance  is  one  of  the  most  powerful 
concepts  and  techniques  in  the  C#  language.  Before  you’re  through  this  chapter,  you’ll 
learn  how  to  subclass  an  object  to  get  its  behavior,  but  keep  the  flexibility  to  make 
changes  to  that  behavior.  You’ll  avoid  duplicate  code,  model  the  real  world  more 
closely,  and  end  up  with  code  that’s  easier  to  maintain. 


Kathleen  does  birthday  parties,  too  206 

We  need  a  Birthday  Party  class  207 

One  more  thing...  can  you  add  a  $100  fee  for  parties  over  12?  213 

When  your  classes  use  inheritance, 

you  only  need  to  write  your  code  once  214 

Build  up  your  class  model  by  starting  general 

and  getting  more  specific  215 

How  would  you  design  a  zoo  simulator?  216 

Use  inheritance  to  avoid  duplicate  code  in  subclasses  2 1 7 
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We  know  that  inheritance  adds  the  base  class  fields, 

properties,  and  methods  to  the  subclass...  225 

A  subclass  can  override  methods  to  change  or 

replace  methods  it  inherited  226 

Any  place  where  you  can  use  a  base  class, 

you  can  use  one  of  its  subclasses  instead  227 

A  subclass  can  access  its  base  class  using  the  base  keyword  232 

When  a  base  class  has  a  constructor,  your  subclass  needs  one  too  233 
Now  you’re  ready  to  finish  the  job  for  Kathleen!  234 
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First  you’ll  build  the  basic  system  240 
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interfaces  and  abstract  classes 

Making  classes  keep  their  promises 

Actions  speak  louder  than  words. 

Sometimes  you  need  to  group  your  objects  together  based  on  the  things  they  can 
do  rather  than  the  classes  they  inherit  from.  That’s  where  interfaces  come  in — they 
let  you  work  with  any  class  that  can  do  the  job.  But  with  great  power  comes  great 
responsibility,  and  any  class  that  implements  an  interface  must  promise  to  fulfill  all  of 
its  obligations...  or  the  compiler  will  break  their  kneecaps,  see? 
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In  the  real  world,  you  don’t  get  to  handle  your  data  in  tiny  little  bits  and  pieces. 
No,  your  data’s  going  to  come  at  you  in  loads,  piles  and  bunches.  You’ll  need 
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The  Quest 

Your  job  is  to  build  an  adventure  game  where  a  mighty 
adventurer  is  on  a  quest  to  defeat  level  after  level  of 
deadly  enemies.  You’ll  build  a  turn-based  system,  which 
means  the  player  makes  one  move  and  then  the  enemies 
make  one  move.  The  player  can  move  or  attack,  and  then 
each  enemy  gets  a  chance  to  move  and  attack.  The  game 
keeps  going  until  the  player  either  defeats  all  the  enemies 
on  all  seven  levels  or  dies. 


The  spec:  build  an  adventure  game 
The  fun’s  just  beginning! 
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dealing  with  important  information.  You  need  to  be  able  to  save  your  work.  In 
this  chapter,  we’ll  look  at  how  to  write  data  to  a  file,  and  then  how  to  read  that 
information  back  in  from  a  file.  You’ll  learn  about  the  .NET  stream  classes, 
and  also  take  a  look  at  the  mysteries  of  hexadecimal  and  binary. 


Eureka ! 
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You’ve  worked  your  tail  off,  waded  through  technical  manuals  and  a  few  engaging 
Head  First  books,  and  you’ve  reached  the  pinnacle  of  your  profession:  master 
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can  even  react  to  those  problems,  and  keep  things  running. 
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that’s  where  LINQ  comes  in.  LINQ  not  only  lets  you  query  data  in  a  simple,  intuitive  way, 
but  it  lets  you  group  data,  and  merge  data  from  different  data  sources. 
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The  fun’s  just  beginning! 

We’ve  shown  you  a  lot  of  great  tools  to  build  some  really  powerful  software  with  C#.  But 
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cut.  But  even  though  we  couldn’t  get  to  them,  we  still  think  that  they’re  important  and 
useful,  and  we  wanted  to  give  you  a  small  head  start  with  them. 
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Intro 


I  can't  believe  they 
put  that  in  a  C# 
programming  book! 


how  to  use  this  book 


Who  is  this  book  for? 

II  you  can  answer  “yes”  to  all  of  these: 

©  Do  you  want  to  learn  C#? 

(2)  Do  you  like  to  tinker— do  you  learn  by  doing,  rather  than 
just  reading? 

Do  you  prefer  stimulating  dinner  party  conversation 
to  dry,  dull,  academic  lectures? 

this  hook  is  for  you. 


Who  should  probably  back  away  from  this  book? 

If  you  can  answer  “yes”  to  any  of  these: 

©  Does  the  idea  of  writing  a  lot  of  code  make  you  bored 
and  a  little  twitchy? 


©  Are  you  a  kick-butt  C++  or  Java  programmer  looking  for 
a  reference  book? 


(3)  Are  you  afraid  to  try  something  different?  Would 
you  rather  have  a  root  canal  than  mix  stripes  with 
plaid?  Do  you  believe  that  a  technical  book  can't  be 
serious  if  C#  concepts  are  anthropomorphized? 


this  hook  is  not  for  you. 


Wdc  from  marketing,  this  book  is 
for  anyone  with  a  Credit  Card  J 
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intro 


the  intro 


We  know  what  you're  thinking. 


"How  can  this  be  a  serious  C#  programming  book?” 
“What’s  with  all  the  graphics?” 


"Can  I  actually  learn  ii  this  way?” 

And  we  know  what  your  brain  is  thinking. 


Your  brain  craves  novelty.  It’s  always  searching,  scanning,  wailing  for 
something  unusual.  It  was  built  that  way,  and  it  helps  you  stay  alive. 

So  what  does  your  brain  do  with  all  the  routine,  ordinary,  normal  things 
you  encounter?  Everything  it  can  to  stop  them  from  interfering  with  the 
brain’s  real  job  recording  things  that  matter.  It  doesn’t  bother  saving 
the  boring  tilings;  they  never  make  it  past  the  "this  is  obviously  not 
important”  filter. 

How  does  your  brain  know  what’s  important?  Suppose  you’re  out  for 
a  day  hike  and  a  tiger  jumps  in  front  of  you,  what  happens  inside  your 
head  and  body? 

Neurons  fire.  Emotions  crank  up.  Chemicals  surge. 

And  that’s  how  your  brain  knows... 


Great.  Only 
700  more  dull, 
dry,  boring  pages 


This  must  be  important!  Don’t  forget  it! 

But  imagine  you’re  at  home,  or  in  a  library.  It’s  a  safe,  warm,  tiger-free  zone. 
You’re  studying.  Getting  ready  for  an  exam.  Or  trying  to  learn  some 
tough  technical  topic  your  boss  thinks  will  take  a  week,  ten  days  at 
the  most. 

Just  one  problem.  Your  brain’s  trying  to  do  you  a  big  favor.  It’s  trying 
to  make  sure  that  this  obviously  noil-important  content  doesn’t  clutter 
up  scarce  resources.  Resources  that  are  better  spent  storing  the  really 
big  tilings.  Like  tigers.  Like  the  danger  of  fire.  Like  how  you  should  M-,u 
never  have  posted  those  “party”  photos  on  your  Facebook  page.  A— 

And  there’s  no  simple  way  to  tell  your  brain.  “Hey  brain,  thank  you 
very  much,  but  no  matter  how  dull  this  book  is,  and  how  little  I’m 
registering  on  the  emotional  Richter  scale  right  now;  I  really  do  want 
you  to  keep  this  stuff  around.”  M 


you  are  here  ► 
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how  to  use  this  book 


We  think  of  a  “Head  First'  reader  as  a  Jgfi . 

So  what  does  it  take  to  learn  somethmg?  Fireh  you^ha^to^  on  ,he 

you  don't  forget  it.  It's  not  abou‘  JroBiology,  and  educational  psychology, 
latest  research  in  cognitive  sci  ,  what  turns  your  brain  on. 

learning  takes  a  lot  more  than  text  on  a  page.  We 

Some  of  the  Head  First  learning  principles: 

e  e  mnre  memorable  than  words  alone,  and 
Make  It  visual.  Image*  « >  ^  g9%  jmprovement  in  recall  and 

make  learning  much  more  e  understandable.  Put  the 

transfer  studies).  It  abom** it  ■  "<= !  relate  to,  rather  than  on 

words  within  or  near  the  gr  P  as  |ike,y  w 

the  bottom  or  on  another  page,  and  learners  will 
solve  problems  related  to  the  content. 

_ _ onnalized  Style.  In  recent  studies, 

Use  a  post-learning  tens  if  the  contemspoke 

students  conve,satlonal  style  rathe,  than 

directly  to  the  reader,  using  P  Use  casual  language. 

r. 

stimulating  dinner  party  companion,  or  a  lecture. 

.  _ I 


f  -  If 

'  j 


l»¥l 


stimuiawny  ' 

.  think  more  deeply.  In  other  words,  unless  you 
Get  the  learner  to  thin  s  in  your  head.  A  reader 

actively  flex  your  neurons,  not  mg  m  ^  w  so(ve  problems,  draw 

has  to  be  motivated,  engaged,  cur.  ,  challenges 

conclusions,  and  generate  new  involve  both 

exercises,  and  thought-provoking  questions,  and  activ, 

sides  of  the  brain  and  multiple  senses. 

a  •  attention.  We've  all  had  the  '1  really  want  to  learn  this  but 
Get— and  keep-the  readers  yo„,  brain  paw  attention  to  things  that  are  out  of 

,  Ca„',  stay  awake  pas,  page  one'  —petted.  teaming  a  new.  tou,  • 

-to  2  Coring.  Vou,  Cain  will  learn  much  mor.gcck,, 

it's  not. 

Touch  their  emotions.  We  now  you  remember  what 

something  is  largely  dependent  on  .  s  We're  not  talking  1 

y0u  care  about.  You  remember  when  emotions  like 

heart-wrenching  stones  about  a  oy  a  ^  ^  Ruler  that  comes  when 

surprise,  curiosity,  fun,  what  the  '  e(se  thjnks  ,s  hard,  or  realize  you 
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Metacognition:  thinking  about  thinking 

If  you  really  want  to  learn,  and  you  want  to  learn  more  quickly  and  more  deeply, 
pay'  attention  to  how  you  pay  attention.  Think  about  how  you  think.  Learn  how  you 
learn. 

Most  of  us  did  not  take  courses  on  metacognition  or  learning  theory  when  we  were 
growing  up.  We  were  expected  to  learn,  but  rarely  taught  to  learn. 

But  we  assume  that  if  you’re  holding  this  book,  you  really  want  to  learn  how  to 
build  programs  in  C#.  And  you  probably  don't  want  to  spend  a  lot  of  time.  If  you 
want  to  use  what  y  ou  read  in  this  book,  you  need  to  remember  what  you  read.  And 
for  that,  you've  got  to  understand  it.  To  get  the  most  from  this  book,  or  any  book  or 
learning  experience,  take  responsibility  for  your  brain.  Your  brain  on  this  content. 

The  u  ick  is  to  gel  your  brain  to  see  the  new  material  you're  learning 
as  Really'  Important.  Crucial  to  your  well-being.  As  important  as 
a  tiger.  Otherwise,  you’re  in  lor  a  constant  battle,  with  your  brain 
doing  its  best  to  keep  the  new  content  from  sticking. 


So  just  how  DO  you  get  your  brain  to  treat  C#  like 
it  was  a  hungry  tiger? 

There’s  the  slow,  tedious  way,  or  the  faster,  more  effective  way. 

The  slow  way  is  about  sheer  repetition.  You  obviously  know  that 
you  are  able  to  learn  and  remember  even  the  dullest  of  topics 
if  you  keep  pounding  the  same  thing  into  your  brain.  With  enough 
repetition,  your  brain  says,  “This  doesn't  fee I  important  to  him,  but  he  keeps  looking 
at  the  same  thing  over  and  over  and  over,  so  I  suppose  it  must  be.” 

The  faster  way  is  to  do  anything  that  increases  brain  activity,  especially'  different 
types  of  brain  activity.  The  things  on  the  previous  page  are  a  big  part  of  the  solution, 
and  they're  all  things  that  have  been  proven  to  help  your  brain  work  in  your  favor.  For 
example,  studies  show  that  putting  words  within  the  pictures  they  describe  (as  opposed  to 
somewhere  else  in  the  page,  like  a  caption  or  in  the  body  text)  causes  your  brain  to  try  to 
makes  sense  of  how  the  words  and  picture  relate,  and  this  causes  more  neurons  to  fire. 
More  neurons  firing  =  more  chances  for  your  brain  to  get  that  this  is  something  worth 
paying  attention  to,  and  possibly  recording. 

A  conversational  style  helps  because  people  tend  to  pay  more  attention  when  they' 
perceive  that  they’re  in  a  conversation,  since  they  're  expected  to  follow  along  and  hold  up 
their  end.  The  amazing  thing  is,  your  brain  doesn't  necessarily  care  that  the  “conversation” 
is  between  you  and  a  book!  On  the  other  hand,  if  the  writing  style  is  formal  and  dry,  your 
brain  perceives  it  the  same  way  you  experience  being  lectured  to  while  sitting  in  a  roomful 
of  passive  attendees.  No  need  to  stay  awake. 

But  pictures  and  conversational  style  are  just  the  beginning. 
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Here's  what  WE  did: 


"to  «.  *£•*  • 

flr.'—  tW  «f»l  «<  t*«  *— « 


We  used  pictures ,  because  your  brain  is  (uned  for  visuals,  not  text.  As  far  as  your 
brain’s  concerned,  a  picture  really  is  worth  a  thousand  words.  And  when  text  and 
pictures  work  together,  we  embedded  the  text  in  the  pictures  because  your  brain 
works  more  effectively  when  the  text  is  within  the  thing  the  text  refers  to,  as  opposed 
to  in  a  caption  or  buried  in  die  text  somewhere. 

We  used  redundancy,  saying  the  same  thing  in  different  ways  and  with  different  media  types, 
and  multiple  senses,  to  increase  the  chance  that  the  content  gets  coded  into  more  than  one  area 
of  your  brain. 


\ 

V  -it.*,— 4.  J  w  ~ 

*<  •«.  i*  ■«  W 


We  used  concepts  and  pictures  in  unexpected  ways  because  your  brain  is  tuned  for  novelty, 
and  we  used  pictures  and  ideas  with  at  least  some  emotional  content,  because  your  brain 
is  tuned  to  pay  attention  to  the  biochemistry  of  emotions.  That  which  causes  you  to  fee! 
something  is  more  likely  to  lie  remembered,  even  if  that  feeling  is  nothing  more  than  a  little 

humor,  surprise,  or  interest. 

We  used  a  personalized,  conversational  style,  because  your  brain  is  tuned  to  pay  more 
attention  when  it  believes  you’re  in  a  conversation  than  if  it  thinks  you’re  passively  listening 
to  a  presentation,  'lour  brain  does  this  even  when  you’re  reading. 

We  included  more  than  80  activities,  because  your  brain  is  tuned  to  learn  and  remember 
more  when  you  do  things  than  when  you  read  about  things.  And  we  made  the  exercises 
challenging-yel-do-able,  because  that’s  what  most  people  prefer. 


We  used  multiple  learning  styles ,  because  )vu  might  prefer  step-by-step  procedures, 
while  someone  else  wants  to  understand  the  big  picture  first,  and  someone  else  just 
wants  to  see  an  example.  But  regardless  of  your  own  learning  preference,  everyone 
benefits  from  seeing  the  same  content  represented  in  multiple  ways. 


BULLET  POINTS 


We  include  content  for  both  sides  of  your  brain ,  because  the  more  of  your  brain  you 
engage,  the  more  likely  you  are  to  learn  and  remember,  and  the  longer  you  can  stay  focused. 
Since  working  one  side  of  the  brain  often  means  giving  the  other  side  a  chance  to  rest,  you 
can  lx‘  more  productive  at  learning  for  a  longer  period  of  time. 

And  we  included  stories  and  exercises  that  present  more  than  one  point  of  view, 
because  your  brain  is  tuned  to  learn  more  deeply  when  it's  forced  to  make  evaluations  and 
judgments. 


Fireside  Chats 


We  included  challenges,  with  exercises,  and  by  asking  questions  that  don’t  always  have 
a  straight  answer,  because  your  brain  is  tuned  to  learn  and  remember  when  it  has  to  work  at 
something.  Think  about  it  -you  can't  get  your  body  in  shape  just  by  watching  people  at  the 
gym.  But  we  did  our  best  to  make  sure  that  when  you're  working  hard,  it’s  on  the  right  things. 
'ITiat you’re  not  spending  one  extra  dendrite  processing  a  hard-to-understand  example, 
or  parsing  difficult,  jargon-laden,  or  overly  terse  text. 

We  used  people.  In  stories,  examples,  pictures,  etc.,  because,  well,  because  you're  a  person. 
And  your  brain  pays  more  attention  to  people  than  it  does  to  things. 
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Here's  what  YOU  can  do  to  bend 
your  brain  into  submission 


So,  we  did  our  part.  The  rest  is  up  to  you.  These  tips  are  a 
starling  point:  listen  to  your  brain  and  figure  out  what  works 
for  you  and  what  doesn't.  Try  new'  things. 

Cut  this  out  stick  it 

your  refirijeritor. 


Oh 


0  Slow  down.  The  more  you  understand, 
the  less  you  have  to  memorize. 

Don’t  just  read.  Stop  and  think.  When  the 
book  asks  you  a  question,  don’t  just  skip  to  the 
answer.  Imagine  that  someone  really  is  asking 
the  question.  The  more  deeply  you  force  your 
brain  to  think,  the  better  chance  you  have  of 
learning  and  remembering. 


(6)  Talk  about  it.  Out  loud. 

Speaking  activates  a  different  part  of  the  brain. 

II’  you’re  trying  to  understand  something,  or 
increase  your  chance  of  remembering  it  later,  say 
it  out  loud.  Better  still,  tryr  to  explain  it  out  loud 
to  someone  else.  You’ll  learn  more  quickly,  and 
you  might  uncover  ideas  you  hadn’t  known  were 
there  when  y  ou  were  reading  about  it. 


(2)  Do  the  exercises.  Write  your  own  notes. 

We  put  them  in.  but  if  we  did  them  for  you. 
that  would  be  like  having  someone  else  do 
your  workouts  lor  you.  And  don’t  just  look  at 
the  exercises.  Use  a  pencil.  There’s  plenty  of 
evidence  that  phy  sical  activity  urhi/e  learning 
can  increase  the  learning. 

(3)  Read  the  “There  are  No  Dumb  Questions” 

That  means  all  of  them.  They  ’re  not  optional 

sidebars—  they’re  part  of  the  core  content! 

Don’t  skip  them. 

(4)  Make  this  the  last  thing  you  read  before 
bed.  Or  at  least  the  last  challenging  thing. 

Fart  of  the  learning  (especially  the  transfer  to 
long-term  memory)  happens  after  you  put  the 
lx>ok  down.  Your  brain  needs  time  on  its  own,  to 
do  more  processing.  If  you  put  in  something  new' 
during  that  processing  time,  some  of  what  you 
just  learned  will  be  lost. 

(5)  Drink  water.  Lots  of  it. 

Your  brain  works  best  in  a  nice  bath  of  fluid. 
Dehydration  (which  can  happen  before  you  ever 
feel  thirsty)  decreases  cognitive  function. 


(7)  Listen  to  your  brain. 

Pay  attention  to  whether  your  brain  is  getting 
overloaded.  If  you  find  yourself  starting  to  skim 
the  surface  or  forget  what  you  just  read,  it’s  time 
for  a  break.  (  )nce  you  go  past  a  certain  point,  you 
won’t  learn  faster  by  trying  to  shove  more  in,  and 
you  might  even  hurt  the  process. 

(8)  Feel  something. 

Your  brain  needs  to  know  that  this  matters.  Get 
involved  with  the  stories.  Make  up  your  own 
captions  for  the  photos.  Groaning  over  a  bad  joke 
is  still  better  than  feeling  nothing  at  all. 

0  Write  a  lot  of  software! 

There’s  only  one  way  to  learn  to  program:  writing 
a  lot  of  code.  And  that’s  what  you’re  going  to  do 
throughout  this  book.  Coding  is  a  skill,  and  the  only 
w  ay’  to  get  good  at  it  is  to  practice.  We’re  going  to 
give  you  a  lot  of  practice:  every  chapter  has  exercises 
that  pose  a  problem  for  you  to  solve.  Don’t  just  ski]) 
over  them — a  lot  of  the  learning  happens  when 
you  solve  the  exercises.  We  included  a  solution  to 
each  exercise  don’t  be  afraid  to  peek  at  the 
solution  if  you  get  stuck!  {It’s  easy  to  get  snagged  on 
something  small.)  But  try  to  solve  the  problem  before 
you  look  at  the  solution.  And  definitely  get  it  working 
before  y  ou  move  on  to  the  next  part  of  the  book. 
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What  you  need  for  this  book: 

We  wrote  this  book  using  Visual  Studio  2008  Express  Edition.  That  means  we  used  C#  3.0  and  the  .NET 
Framework  3.5.  The  tiling  is,  when  we  wrote  this  book.  Visual  Studio  2008  was  still  in  beta,  and  it  won’t 
be  released  until  after  die  first  printing.  But  we  know-  diat  every  single  exercise  and  piece  of  code  in  the 
book  works  100%  with  the  current  beta  version  of  Visual  Studio  2008  Express.  So  we  recommend  that  you 
download  it  from  Microsoft’s  website — it’s  free  to  download  and  use. 

- SETTING  UP  VISUAL  STUDIO  2008  EXPRESS  EDITION  - 

■  Before  you  start,  keep  in  mind  that  if  you  bought  this  book  in  the  first  few  months  after  it  was  released,  you're 
probably  going  to  be  using  a  beta  version  of  Visual  Studio  2008  Express  Edition,  so  the  usual  beta  version 
warnings  apply.  We  did  that  because  there  have  been  some  really  amazing  improvements  to  C#  and  .NET, 
and  we  wanted  to  make  sure  that  you  learned  about  them.  And  just  so  you  know,  we  haven't  had  a  single 
problem  using  the  VS2008  beta 

■  It's  easy  enough  to  download  and  install  Visual  C#  2008  Express  Edition.  Here's  the  link  to  the  Visual  Studio 
2008  Express  Edition  download  page: 

http: //msdn2 .microsof t . com/en-us/express/future/bb421473 . aspx 

Make  sure  that  you  check  all  of  the  options  when  you  install  it.  ^  V01*  absolutely  use  a*> 

older  version  of  l/isual  Studio, 

C#  or  the  NET  Framework, 
the*  please  keep  in  mind  that 
you'll  Come  across  top >Cs  in  this 
book  that  won't  be  Compatible 
W'tb  your  version.  The  C#  team 
at  Microsoft  has  added  some 


these  top.es.  But  definitely 
keep  in  mind  that  if  you  re  not 
using  the  latest  version,  there 
will  be  some  Code  in  this  book 
that  won't  work, 


pretty  Cool  features  to  the 
language  Wr'll  give  you  warnings 
when  we  talk  about  any  of 


^  Microsoft  Visual  O  2008  Express  [diflan  Setup  f^j  fx] 


InVaJMnnUptnm  V’lSUal  C#  2008 

Express  Edition 

Select  the  c**crvsl  rxodjetfs)  you  *<oJd  He  to  tnstol 

[ylMSOMimey  for  VWual  Studio  2D08  lupress  l  tie  tons  (Download  Sttc  72  MB) 

The  MSMI  E<prtts  Itmry  conus*  »l*ionil  product  dorcuwrUtton  for  a I  Usual  SCudto 
itre « tdticn*  You  can  choose  to  renal  M50W  C -cress  Lfcrarv  at  a  Idler  bme,  See  the 
Reacxr*  for  more  nformabon. 

FlMfermoft  SQL  Server  ZOOS  txprrss  ft*  ton  m«.  (Download  Sire:  *»  MB) 

5QL  Seva  Extras*  ts  a  tMtic  w non  of  Mnosoft  SQi  Server  that  alow*  you  to  eatly  read, 
**<e.  and  deploy  acckabon  data. 

0Mkro*o#l  SQL  Server  Comport  3.5  (Download  Sire:  1.6  MB) 

SQLServer  Compact  3  5  is  a  corrpact  database  that  can  be  deployed  w*h  appfcatnro  on 
desttep  c  jnpjtet s.  am it  dewes.  and  Tablet  PCs. 

FlMfcioeoft  SQL  Server  Compact  1.5  Design  Tools  (Download  Stee  2.4  MB) 

Tools  for  Vtaual  Stuto  that  alow  you  to  work  wth  SQL  Server  Coepect  3.5 


X/  for  more  nformabon,  see  the  t;.ci.dmc  hte 

1  <  Prewous  ,  |  Nerf  >  |  [  Caned  j 


■  Download  the  installation  package  for  Visual  C#  2008  Express  Edition.  Make  sure  you  do  a  complete 
installation  That  should  install  everything  that  you  need:  the  IDE  (which  you'll  learn  about),  SQL  Server 
Express  Edition,  and  NET  Framework  3.5. 

■  Once  you've  got  it  installed,  you'll  have  a  new  Start  menu  option:  Microsoft  Visual  C#  2008  Express  Edition 
Click  on  it  to  bring  up  the  IDE,  and  you're  all  set. 
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Read  me 

This  is  a  learning  experience,  not  a  reference  book.  We  deliberately  stripped  out 
everything  that  might  get  in  the  way  of  learning  whatever  it  is  we’re  working  on  at 
that  point  in  the  book.  And  the  first  time  through,  you  need  to  begin  at  the  beginning, 
because  the  book  makes  assumptions  about  what  you’ve  already  seen  and  learned. 


The  activities  are  NOT  optional. 

The  exercises  and  activities  are  not  add-ons;  they’re  part  of  the  core  content  of  the 
book.  Some  of  them  are  to  help  with  memory,  some  for  understanding,  and  some  to 
help  you  apply  what  you’ve  learned.  Don 't  skip  the  exercises.  The  crossword  puzzles 
are  the  only  things  you  don't  have  to  do,  but  they’re  good  for  giving  your  brain  a  chance 
to  think  about  the  words  from  a  different  context. 


„ik(  ui''  <3i,tv 

to  understand  ^ 


The  redundancy  is  intentional  and  important. 

One  distinct  difference  in  a  Head  First  book  is  that  we  want  you  to  really  get  it.  And  we 
want  you  to  finish  the  book  remembering  what  you’ve  learned.  Most  reference  books 
don't  have  retention  and  recall  as  a  goal,  but  this  book  is  about  learning ,  so  you'll  see 
some  of  the  same  concepts  come  up  more  than  once. 


You  should  do  ALL-/  the 
"Sharpen  '/owr  1**^  attw.t>es 

1 1 


Do  all  the  exercises! 

The  one  big  assumption  that  we  made  when  we  wrote  tliis  book  is  that  you  want  to 
learn  how  to  program  in  G#.  So  we  know  you  want  to  get  your  hands  dirts1  right  away, 
and  dig  right  into  the  code.  We  gave  you  a  lot  of  opportunities  to  sharpen  your  skills 

by  putting  exercises  in  every  chapter.  We've  labeled  some  of  them  ‘‘Dp  tlfis!” — when 
you  see  that,  it  means  that  we'll  walk  you  through  all  of  the  steps  to  solve  a  particular 
problem.  But  when  you  see  the  Exercise  logo  with  the  running  shoes,  then  we’ve  left 
a  big  portion  of  die  problem  up  to  you  to  solve,  and  we  gave  you  the  solution  diat  we 
came  up  with.  Don't  be  afraid  to  peek  at  the  solution — it’s  not  cheating!  But  you'll 
leani  the  most  if  you  try  to  solve  the  problem  first. 


We’ve  also  placed  all  the  exercise  solutions'  source  code  on  the  web  so  you  can  download 
it.  You’ll  find  it  at  http :  /  /www .  headfirstlabs .  com/books/hf  csharp/ 

The  “Brain  Power”  exercises  don’t  have  answers. 

For  some  of  diem,  there  is  no  right  answer,  and  for  others,  part  of  the  learning 
experience  of  the  Brain  Power  activities  is  for  you  to  decide  if  and  when  your  answers 
are  right.  In  some  of  the  Brain  Power  exercises  you  will  find  hints  to  point  you  in  the 
right  direction. 
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Lisa  Kellner  Joe  Albahav-i 


J ay  Hilyard 


A^yam  Sinoh 


Theodore  Casser  Andy  Parker 


Peter  RiUhie 


Daniel  k^innaer 
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just  as  awesome) 
iVayne  Bradney, 
Dave  Murdoch, 
and  Bridgette 
!  Julie  Landers 


Bill  /VJietelski 


Technical  Reviewers: 

When  we  wrote  this  I  took,  it  had  a  bunch  of  mistakes,  issues,  problems,  typos, 
and  terrible  arithmetic  errors.  Okay,  it  wasn't  quite  that  bad.  But  we’re  still 
really  grateful  lor  the  work  that  our  technical  reviewers  did  for  the  book.  We 
would  have  gone  to  press  with  errors  (including  one  or  two  big  ones)  had  it  not 
been  for  the  most  kick-ass  review  team  EVER... 

First  of  all.  we  teallv  want  to  thank  Joe  Albahari  for  the  enormous  amount 
of  technical  guidance.  He  really  set  us  straight  on  a  few  really  important  things, 
and  if  it  weren’t  for  him  you’d  be  learning  incorrect  stuff.  We  also  want  to 
thank  Lisa  Kellner  this  is  our  third  btx)k  that  she’s  reviewed  lor  us,  and 
she  made  a  huge  difference  in  the  readability  of  the  final  product.  Thanks, 

Lisa!  And  special  thanks  to  Jay  Hilyard  and  Daniel  Kinnaer  lor  catching 
and  fixing  a  whole  lot  of  our  mistakes,  and  Aayam  Singh  for  actually  going 
through  and  doing  every  one  of  these  execises  before  we  fixed  them  and 
corrected  their  problems.  Aayam,  you're  really  dedicated.  Thanks! 


KVishnd  Pala 


Giuseppe  Tutri-fc-fco 
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1  get  productive  With  c# 


Visual  Applications,  in  10 

minutes  or  less 


Don't  worry,  Mother.  With  Visual 
Studio  and  C#,  you'll  be  able  to 
program  so  fast  that  you’ll  never 
burn  the  pot  roast  again. 


Want  to  build  great  programs  really  fast? 

With  C#,  you've  got  a  powerful  programming  language  and  a  valuable  tool 

at  your  fingertips.  With  the  Visual  Studio  IDE,  you’ll  never  have  to  spend  hours 
writing  obscure  code  to  get  a  button  working  again.  Even  better,  you’ll  be  able 
to  focus  on  getting  your  work  done,  rather  than  remembering  which  method 
parameter  was  for  the  name  for  a  button,  and  which  one  was  for  its  label. 
Sound  appealing?  Turn  the  page,  and  let's  get  programming 


this  is  a  new  chapter  1 


c#  makes  it  easy 


Why  yog  should  learn  C# 

C#  anti  the  Visual  Studio  IDE  make  it  easy  for  you  to  get  to  the  business 
of  writing  code,  and  writing  it  fast.  When  you’re  working  with  C#.  the 
IDE  is  your  best  friend  and  constant  companion. 


Here's  what  the  1PE  automates  for  you... 

Every  time  you  want  to  get  started  writing  a  program, 
or  just  putting  a  button  on  a  form,  your  program  needs 
a  whole  bunch  of  repetitive  code. 


\  “^apa« 

atellc  CUI.  ptwjrw 

’  m  <sumity>  lnt  for  the  application. 

///  ?>ve  wA*n  en^ry 
/ft  </*uomary> 

SgilSISS:!S«SS  *«io.. 


The  IDE— or  Visual  Studio  Integrated 
Development  Environment— is  an 
important  part  of  working  in  C#  It 
a  program  that  helps  you  edit  your 
code,  manage  your  files,  and  publish  y < 
projects. 


What  you  get  with  Visual  Studio  and  C#... 

W  ith  a  language  like  C#,  tuned  for  Windows 
programming,  and  the  Visual  Studio  IDE,  you  can  focus 
on  what  your  program  is  supposed  to  do  immediately: 


-LeCo^T-  - 

’ SWmMliySS ( *»«*■•  »l»dow  •  Font.  (J  , 

//  button 1 

561, 

u  For,,  *m«.E,„0taodUr(thi,.hlttonl_CUcl 

i,r" 

2“Io°d*-,ont' 

thla.Beauniuyout  (falaej  t 


'  ii^ttS3"i},r£odeMiod^ 

button  on  a  form.  Adding  a  few 
^kc  is?  tin*!  as  mueh  Code 


c 


The  iresuli  ,s 
looking  jpp|ld< 
^kes  less  tim 


Forts' 


.NET  Framework 
solutions 


Visual  SW'O 
pvc— W»l”t 
.  that  handle  the 
,de  that’s  part  oV 
jamming  tasks 


Input  Let's  get  started* 

How  good?  O  Good  O  Better  0  Best 

-  J 

l  Do  it  now 

AJ  n^itl 

Data  access 
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get  productive  with  c# 


C*  and  the  Visual  Studio  IPE  make 
lots  of  things  easy 

When  you  use  C#  and  Visual  Studio,  you  gel  all  of 
these  great  features,  without  having  to  do  any  extra 
work.  Together,  they  let  you: 


o 


Build  an  application,  FAST.  Creating  programs  in  G#  is  a  snap.  The 
language  is  powerful  and  easy  to  learn,  and  the  Visual  Studio  IDE  does  a  lot 
of  work  for  you  automatically.  You  can  leave  mundane  coding  tasks  to  the  IDE 
and  focus  on  what  your  code  should  accomplish. 


o 


Design  a  great  looking  user  interface.  The  Form  Designer  in  the 
Visual  Studio  IDE  is  one  of  the  easiest  design  tools  to  use  out  there.  It 
does  so  much  for  you  that  you’ll  find  that  making  stunning  user  interfaces 
is  one  of  the  most  satisfying  parts  of  developing  a  C#  application.  You  can 
build  full-featured  professional  programs  without  having  to  spend  hours 
writing  a  graphical  user  interface  entirely  from  scratch. 


Q  Create  and  interact  with  databases.  The  IDE  includes  a  simple 

interface  for  building  databases,  and  integrates  seamlessly  with  SQL  Server 
Express,  its  well  as  several  other  popular  database  systems. 


o  Focus  on  solving  your  REAL  problems.  The  IDE  does  a  lot  for  you,  but 

you  are  still  in  control  of  what  you  build  with  C#.  The  IDE  just  lets  you  focus  on 
your  program,  your  work  (or  fun!),  and  your  customers.  But  the  IDE  handles  all  the 
grunt  work,  such  as: 

*  Keeping  track  of  all  of  your  projects 

*  Making  it  easy  to  edit  your  project’s  code 

*  Keeping  track  of  your  project's  graphics,  audio,  icons,  and  other  resources 

*  Managing  and  interacting  with  databases 

All  this  means  you'll  have  all  the  time  you  would’ve  spent  doing  this  routine 
programming  to  put  into  building  killer  programs. 


-  you’re  tjoinj  jp  see  esadtly 
u/haL  v*e  mean  ne*L 
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the  boss  needs  your  help 


Help  the  CEO  go  paperless 

The  Objectville  Paper  Company  just  hired  a  new  CEO.  He  loves  hiking, 
coffee,  and  nature...  and  he’s  decided  that  to  help  save  forests.  He  wants 
to  become  a  paperless  executive,  starting  with  his  contacts.  He’s  heading 
to  Aspen  to  go  ski  for  the  weekend,  and  expects  a  new  address  book 
program  by  the  time  he  gets  back.  Otherwise...  well...  it  won’t  be  just 
the  old  CEO  who’s  looking  for  a  job. 


Name:  Laverne  S>rrnth 

■w  PjilHir  COMtpwty 

Company:  X"/2:  industries 
Telephone:  (aia)S5S-8ia9 
Email:  Laverre.$^dh(?baj2ir\dustnescom 
Client:  "tes  Last  call:  os/ato/oi 


You'd  better  £i*d  a  'u*'1 
to  get  this  data  onto  the 
CEO’s  laptop  <\uidk 
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fret  to  know  your  users'  needs  before  you 
start  building  your  program 

Before  we  can  slarl  writing  the  address  book  application — or  any 
application  we  need  to  take  a  minute  and  think  about  who’s  going  to 
be  using  it.  and  what  they  need  from  the  application. 


© 


The  CEO  needs  to  be  able  to  run  his  address  hook  program 
at  work  and  on  his  laptop  too.  He'll  need  an  installer  to 
make  sure  that  all  of  the  right  files  get  onto  each  machine. 


Tke  CBC  wants  to  be  able  to  run  bis 
program  on  bis  desktop  and  laptop,  so 
an  installer  is  a  must 


© 


Hie  Objectville  Paper  company  sales  team  wants  to 
access  his  address  book,  too.  They  can  use  his  data  to 
build  mailing  lists  and  get  client  leads  for  more  paper 
sales. 


The  CEO  figures  a  database  would  be  the  best  way  that 
everyone  in  the  company  to  see  his  data,  and  then  he 
can  just  keep  up  with  one  copy  of  all  his  contacts. 


SQL 

Database 
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here's  your  goal 


Here's  what  you're  going  to  build 

You’re  going  to  need  an  application  with  a  graphical  user 
interface,  objects  to  talk  to  a  database,  (he  database  itself,  and 
an  installer.  It  sounds  like  a  lot  of  work,  but  you’ll  build  all  of 
this  over  the  next  few  pages. 


Here’s  the  structure  of  the  program  we’re  going  to  create: 


v/  *\\  W  *  .  •  L  ^ 

t**  -  *• 


V>vn£-h 


.NET  Visual  Objects 


fcath  of  these  objetts 
reyveserts  3  Control 
or,  the  address  book 
^orn,  vic'll  Create 


the  database 


m 

{ 


SELECT  command 


data  ed^ 


.NET  database  Objects  1  insert  | 

|  UPDATE  command  ( 

|  DELETE  command  ^ 


mi*['d  object  to  talk  to 

di^to'etour 
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The  data  is  all  s^rtA  .  ,  . 


0nde  -tV»e  program's  built, 
it'll  be  padkayd  up  into  a 


VVmdovjs  installer.  I 


Pata  Storage 


Table 


DB  diagram 
support  objects 


Here's  tbe  database  itself  wbidb 
Visual  Studio  will  Help  us  dreate 
and  maintain- 


Peploywewt  Package 


TV  sales 
department  will 
►'fed  to 
P«"t  and  dlidc 
ihs^H  and 
^Vn  use  his 
P*"°3ram 
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let’s  get  started 


What  you  do  in  Visual  Studio... 

(in  ahead  and  start  up  Visual  Studio,  if  you  haven’t  already.  Skip  over 
the  start  page  and  select  New  Project  from  the  File  menu.  Name  your 
project  “Contacts”  and  click  OK. 


What  Visual  Studio  does  for  you... 

e  - 

.As  soon  as  you  save  the  project,  the  11)F,  creates  a  Form  I  .cs.  Form  I. 
Designer.es,  and  Program.es  file  when  you  create  a  new  project.  It  adds 
these  to  the  Solution  Explorer  window,  and  by  default,  puts  those  files  in  My 
DocumentsWisual  Studio  2008\Projects\Contacts\. 

This  -file  Contains  -the  C#  This  has  the  Code 
code  -that  def  ines  the  that  starts  ^ 

behavior  of  the  form. 


the  program  and 
delays  the  form 


Forml.cs 


Program.es 

Visual  Studio  creates  all  three  of 
these  files  automatically- 
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Watch  it! 


Things  may 
look  a  bit 
different  in 
your  IDE. 

This  is  what 


the  “New  Project"  window 
looks  like  in  Visual 


Studio  2008  Express 
Edition.  If  you're  using 
the  Professional  or  Team 


Foundation  edition,  it 
might  be  a  bit  different.  But 
don’t  worry,  everything  still 
works  exactly  the  same. 


Make  sure  that  you  save  your  project 
as  soon  as  you  Create  it  by  selecting 
“Save  AH”  ho*  the  File  menu— that’ll 
save  all  of  the  project  files  out  to 
the  folder.  |f  you  select  "Save”,  rt 
just  saves  the  one  you’re  working  on 


"The  Code  that 

defines  the  form 


J*d  its  objects 
lives  here.  ) 


Forml  .Designer.es 
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Below  is  what  your  screen  probably  looks  like  right  now.  You  should  be 
able  to  figure  out  what  most  of  these  windows  and  files  are  based  on 
what  you  already  know.  In  each  of  the  blanks,  try  and  fill  in  an  annotation 
saying  what  that  part  of  the  IDE  does.  We've  done  one  to  get  you  started. 


{oo,b^  ^  buttons 
tM:  apply  to  yoilVe 

Currently  doing  ir>  the  /££ 


If  your  IDE  doesn't  look  e*adtly  like  this 
pidure,  you  dan  seledt  "Reset  Window  Layout" 
•from  the  Window  menu. 


We’ve  blown  up  this 
window  below  so  you 
have  more  room 


Solution  Explorer  -  Contacts 

a  BD 

□  Solution  'Contacts'  (1  project) 
a  Contacts 
a  M  Properties 
a  id  References 
ilForml.es 
Program.es 
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We've  filled  in  the  annotations  about  the  different  sections  of  the  Visual 
Studio  C#  IDE.  You  may  have  some  different  things  written  down,  but  you 
should  have  been  able  to  figure  out  the  basics  of  what  each  window  and 
section  of  the  IDE  is  used  for. 
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thcreicire  no 

Dumb  Questions 


U:  So  if  the  IDE  writes  all  this  code 
for  me,  is  learning  C#  just  a  matter  of 
learning  how  to  use  the  IDE? 

No.  The  IDE  is  great  at  automatically 
generating  some  code  for  you,  but  it  can 
only  do  so  much.  There  are  some  things  it’s 
really  good  at,  like  setting  up  good  starting 
points  for  you,  and  automatically  changing 
properties  of  controls  on  your  forms  But 
the  hard  part  of  programming— figuring 
what  your  program  needs  to  do  and  making 
it  do  it— is  something  that  no  IDE  can  do 
for  you  Even  though  the  Visual  Studio  IDE 
is  one  of  the  most  advanced  development 
environments  out  there,  it  can  only  go  so  far. 
It's  you— not  the  IDE— who  writes  the  action 
code,  or  the  code  that  does  the  work 


o* 

V;  I  created  a  new  project  in  Visual 
Studio,  but  when  I  went  into  the  “Projects” 
folder  under  My  Documents,  I  didn't  see  it 
there.  What  gives? 

First  of  all,  you  must  be  using  Visual 
Studio  2008— in  2005.  this  doesn  t  happen 
When  you  first  create  a  new  project  in 
Visual  Studio  2008,  the  IDE  creates  the 
project  in  your  Local  Settings  \ 
Application  Data\Temporary 
Projects  folder.  When  you  save  the 
project  for  the  first  time,  it  will  prompt  you 
for  a  new  filename,  and  save  it  in  the  My 
DocumentsWisual  Studio 
2008\Projects  folder.  If  you  try  to 
open  a  new  project  or  close  the  temporary 
one,  you’ll  be  prompted  to  either  save  or 
discard  the  temporary  project. 

Qj  What  if  the  IDE  creates  code  I  don’t 
want  in  my  project? 


You  can  change  it.  The  IDE  is  set  up  to 
create  code  based  on  the  way  the  element 
you  dragged  or  added  is  most  commonly 
used.  But  sometimes  that’s  not  exactly  what 
you  wanted.  Everything  the  IDE  does  for 
you— every  line  of  code  it  creates,  every  file 
it  adds— can  be  changed,  either  manually  by 
editing  the  files  directly  or  through  an  easy- 
to-use  interface  in  the  IDE. 

Qj  Is  it  OK  that  I  downloaded  and 
installed  Visual  Studio  Express?  Or  do 
I  need  to  use  one  of  the  versions  of 
Visual  Studio  that  isn’t  free  in  order  to  do 
everything  in  this  book? 

There  s  nothing  in  this  book  that  you 
can’t  do  with  the  free  version  of  Visual  Studio 
(which  you  can  download  from  Microsoft’s 
website).  The  main  differences  between 
Express  and  the  other  editions  (Professional 
and  Team  Foundation)  aren’t  going  to  get 
in  the  way  of  writing  C#  and  creating  fully 
functional,  complete  applications. 

Qj  Can  I  change  the  names  of  files  the 
IDE  generates  for  me? 

Absolutely,  you  can  change  any  aspect 
of  your  program  But  the  IDE  is  set  up  to 
name  your  files  sensibly.  When  you  add  a 
file  to  your  project,  the  filename  you  choose 
affects  the  way  the  code  is  generated,  and 
the  code  it  generates  will  include  that  name. 
In  some  cases,  if  you  rename  the  file  you’ll 
either  have  to  go  through  and  change  other 
parts  of  the  code,  or  live  with  the  difference 
between  the  filename  and  the  code  inside  it. 
Since  that’s  a  bit  of  a  pain,  we  recommend 
you  don't  change  filenames  unless  you've 
got  a  really  good  reason  to 


U:  I'm  looking  at  the  IDE  right  now, 
but  my  screen  doesn't  look  like  yours!  It's 
missing  some  of  the  windows,  and  others 
are  in  the  wrong  place.  What  gives? 

If  you  click  on  the  “Reset  Window 
Layout”  command  under  the  "Window”  menu, 
the  IDE  will  restore  the  default  window  layout 
for  you.  Then  your  screen  will  look  just  like 
the  ones  in  this  chapter 

Visual  Studio  will 
generate  code 
you  can  use  as  a 
starting  point  for 
your  applications. 

Making  sure 
tke  application 
does  wkat  it’s 
supposed  to  do  is 
still  up  to  you. 
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a  picturebox  is  worth  a  thousand  words 


develop  the  user  interface 

Adding  controls  and  polishing  the  user  interface  is  as  easy  as 
dragging  and  dropping  with  the  Visual  Studio  IDE.  Let’s  add  a 
logo  to  die  form: 


Q  Use  the  PictureBox  control  to  add  a  picture. 

Click  on  the  PictureBox  control  in  the  Toolbox,  and  drag  it 
onto  your  form.  In  the  background,  the  IDE  added  code  to 
Forml .  Designer .  cs  for  a  new  picture  control. 

- - - - 1 

If  you  don't  see  j 
the  toolbox,  try  " "/'Toolbox 


hovering  over  the, 
word  “Toolbox” 


I  that  shows  up 
j  in  the  upper 


left-hand  corner 


|  of  the  IDE.  If  it’s  j 
j  not  there,  select  j 
|  “Toolbox”  from 
j  the  View  menu  toi 
’  make  it  appear  j 


l. 


“  MaskedTextBox 
fditl  MonthCatendar 
7^1  Notlfylcon 

Jjj  PictureBox 

©  RaoU'jtW 
RichTextBox 
S  TextBox 
^3  ToolTip 
“sr  Tree  View 
33  WebBrowser 

&  Containers 
1^  Pointer 

FlowLayoutPanel 
Q  GroupBox 
|  |  Panel 
fTI  SplitCorVaner 

i  TahC  nrVrni 

^Toobox  [^Database 


Every  time  y*.  ^  a  ^  a  ^^ol's 

-the  Code  in  Forml. 

D  Ay,e<r  tS  ,s  *^"9  Changed  by  ihe  IDE. 


Forml  .Designer.es 


It’s  OK  if  you’re  not  a  pro  at  user 
interface  design. 

We’ll  talk  a  lot  more  about  designing 
good  user  interfaces  later  on.  For  now, 
just  get  the  logo  and  other  controls  on  your  form,  and 
worry  about  behai>ior.  We’ll  add  some  style  later. 
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o 


'/cu  i(ie  flew 


Set  the  PictureBox  to  Zoom  mode. 


.NET  Visual 
OblMts 


.NET 


Pata  Storage 

A  P 


I 


Veploymewt 

Paekage 


Every  control  on  your  form  has  properties  that  you  can 
set.  Click  the  little  black  arrow  for  a  control  to  access 


these  properties.  Change  the  PictureBox ‘s  Size  property 
to  “Zoom”  to  see  how  this  works: 


Q  Download  the  Objectville  Paper  Company  logo. 

Download  the  ()bject\ille  Paper  Co.  logo  from  Head  First  Eabs 
http://www.headfirstlabs.com/books/hfcsharp 

and  save  it  to  your  hard  drive.  Then  click  the  PictureBox  properties 
arrow,  and  select  Choose  Image.  Click  Import,  find  your  logo,  and 
you're  all  set: 


.*s  the  OPC  loa¬ 
the  P  ttVe&o* 
yt  s,~ 

t  r 
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conserving  c#’s  natural  resources 


Visual  Studio,  behind  the  scenes 

Every  time  you  do  something  in  the  Visual  Studio  IDE,  the  IDE  is 
writing  code  for  you.  When  you  created  the  logo  and  told  Visual 
Studio  to  use  the  image  you  downloaded,  Visual  Studio  created  a  resource 
and  associated  it  with  your  application.  A  resource  is  any  graphics  file, 
audio  file,  icon,  or  other  kind  of  data  file  that  gets  bundled  with  your 
application.  The  graphic  file  gets  integrated  into  the  program,  so  that 
when  it’s  installed  on  another  computer,  the  graphic  is  installed  along  with 
it  and  the  PictureBox  can  use  it. 

When  you  dragged  the  PictureBox  control  onto  your  form,  the  IDE 
automatically  created  a  resource  file  called  Form  I  .resx  to  store  that 
resource  and  keep  it  in  the  project.  Double-click  on  this  file,  and  you’ll  be 
able  to  see  the  newly  imported  image. 


\r\ 

1  iWiiiFnrMw 

i_ 

/ 

This  invade  is  now  a  resource  ot  -the 
Contact  List  application. 


la  ^3  sn 

Q  Solution  'Contacts'  (1  project) 
B  3  Contacts 
a  m  Properties 
a  Si  References 
B  UForml.cs 

^  FormLDesigner.es 

^  esse 

C|J  Program.es 


^Solution  Explorer  '2J  Class 


View 


It  you  click  on  Form/. resx  in  the 
Solution  Explorer,  you  can  see  the  Uo 
that  you  imported  That  file  is  what 
.t  to  the  PictureBox,  and  the  IDE 
added  Code  to  do  the  linki^. 

forml.r ex'  Fwml.cs*  |  Fornii.es [Design]' 
j|  Images  -  _]  Add  Resource  •  X  Remove  ReJ 


Forml  .Designer.es 


hhe  ?ileS 
Were  art  the 

Visual  ■ 

created  earlier 


Forml.cs 


Forml  .resx 


When  you  imported  the  'may,  the 

IDE  created  this  fit e  tor  you 
It  contains  all  ot  the  resources 
(oraph.es,  video,  audio  and  other 
stored  data)  associated  with  Forml- 


Program.es 
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Add  to  the  auto-generated  code 


Hie  IDE  creates  lots  of  code  for  you,  hut  you'll  still  want  to  get 
into  this  code  and  add  to  it.  Let’s  set  the  logo  up  to  show  an  About 
message  when  the  users  double-click  on  it. 

Make  sure  you’ve  got  your  form  showing  in  the  IDE,  and 
double-click  on  the  PicturcBox  control.  You  should  see  some  code 
pop  up  that  looks  like  this: 


public  partial  class  Forml  :  Form 
{ 


public  Forml () 
{ 


Initial izeComponent () ; 


private  void  pictureBoxl_Click (object  sender,  EventArgs  e) 


When  you  double-clicked  on  the  PictureBo*  Control, 
the  IDE  Created  this  method  It  will  run  every  time 
a  user  clicks  on  the  logo  in  the  running  application 

This  method  name  4 


Aen  someone  tUcks  on 
P.ctureBo*  control 


MessageBox. Show ("Con tact  List  1 . 0 . \nWritten  by:  STour  Name”,  "About"); 


When  you  double-click  on  the 
PictureBoX,  it  will  open  this 
Code  up  with  a  Cursor  blinking 
right  here  Ignore  any  windows 
the  IDE  pops  up  as  you  type, 
it's  trying  to  help  you,  but  we 
don't  need  that  right  now 


9 


L^/n  ^ IBe  Code  H  /j 

r  k.ljTT  w,th  the  iJ  £*"**»* 

box  be  titled  “About"  ^  P'r0V,<Je  Tl* 


flierejOre  no 

Dumb  Questions 


Q:  What's  a  method? 

A  method  is  just  a  named  block  of  code 
We  ll  talk  a  lot  more  about  methods  in  Chapter  2. 


* 


Once  you’ve  typed  in  the  line 
erf  code,  save  it  using  the  Save 
.ton  on  the  IDE  toolbar  or 
by  selecting  "Save"  from  the 
pile  menu  tjet  in  the  habit  ok 
doing  "Save  AH”  re^larly' 


What  does  that  In  thing  do? 


O: 

That's  a  line  break  It  tells  C#  to  put 
"Contact  List  1.0."  on  one  line,  and  then  start  a 
new  line  for  “Written  by:". 


you  are  here  ► 
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run  the  app  (already!) 


You  can  already  run  your  application 


Press  the  F5  key  on  your  keyboard,  or  click  the  green 
arrow  button  (,  ►  on  the  toolbar  to  check  out  what  you’ve 
done  so  far.  (This  is  called  “Debugging”,  which  just  means 
running  your  program  using  the  IDE.)  You  can  stop 


debugging  by  selecting  “Stop  Debugging”  from  the  Debug 
menu  or  clicking  this  toolbar  button:  J  i. 


-  n,x 


Contact  List  1 .0 
Written  by:  You  Name 


OK 


■  I'd'  to  make  them  J 


Clicking  on  the 

OPC  I o^o  brings  up 
the  About  box  you 
iust  Coded 


Where  are  my  files? 

When  you  run  your  program.  Visual  Studio  copies 
all  of  your  files  to  My  Do cume nts\Visual 
Studio  2008\Projects\Contacts\ 
Contacts\bin\debug.  You  can  even  hop  over 
to  that  directory  and  run  your  program  by  double* 
■ clicking  on  the  .exc  file  the  IDE  creates. 


Ctt  turns  your 
program  into  a 
tile  that  you  can 
run,  called  an 
executable  You'll 
•find  it  in  here,  in 
the  debu^  folder 


Forml.cs  Forml.rasx  Properties 


This  isn’t  a  mistake,  there  are  two  levels  of  folders.  The  inner 
folder  has  the  actual  C#  Code  files. 


tliereisre  no 

—  Dumb  Questions  - 
O: 

n  my  IDE,  the  green  arrow  is  marked  as 
“Debug”.  Is  that  a  problem? 

A. 

n,-  No.  Debugging,  at  least  for  our  purposes 
right  now,  just  means  running  your  application 
inside  the  IDE.  We  ll  talk  a  lot  more  about 
debugging  later,  but  for  now,  you  can  simply  think 
about  it  as  a  way  to  run  your  program. 

Q: 

don't  see  the  Stop  Debugging  button 
on  my  toolbar.  What  gives? 

The  Stop  Debugging  button  only  shows 
up  In  a  special  toolbar  that  only  shows  up 
when  your  program  is  running  Try  starting  the 
application  again,  and  see  if  it  appears. 
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Here's  what  we've  done  so  far 


We’ve  built  a  form  and  created  a  Picture  Box  object  that  pops  up  a 
message  box  when  it’s  clicked  on.  Next,  we  need  to  add  all  the  other 
fields  from  the  card,  like  the  contact’s  name  and  phone  number. 

Let’s  store  that  information  in  a  database.  Visual  Studio  can  connect 
fields  directly  to  that  database  for  us,  which  means  we  don’t  have  to 
mess  with  lots  of  database  access  code  (which  is  good).  But  for  that 
to  work,  we  need  to  create  our  database  so  that  the  controls  on  the 
form  c;ui  hook  up  to  it.  So  we’re  going  to  jump  from  the  .NET  Visual 
Objects  straight  to  the  Data  Storage  section. 

m  Visual 
Objects 


Wctne',  we've 
already  done  . 


we  we  *»  *«< vr 

bbjetts  to 

Jh  the  data  well  ^ 

in  our  database 


.NET 
database \ 


This  step  is  a(,ou 
Connecting  our  fc 
to  the  database, 
we  re  not  ready  j 
‘t  yet,  since  we  d 
h^re  a  database. 


/ 


Pata  Storage  Peploywent 
Package 


on  this  stey  ne*t: 
creating  our  database, 
and  yutting  some 

initial  data  mto  *t 


Visual  Studio  can  generate  code  to  connect  your 
form  to  a  database,  but  you  need  to  bave  tbe 
database  in  place  BEFORE  generating  tbat  code. 


you  are  here  ► 
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save  it  for  later 


We  need  a  database  to  store  our  information 


Before  we  add  the  rest  of  the  fields  to  the  lorm,  we  need 
to  create  a  database  to  hook  the  form  up  to.  The  IDE 
can  create  lots  of  the  code  for  connecting  our  form  to 
our  data,  but  we  need  to  define  the  database  itself  first. 


•  *1*33*3 

Wwne  y-**  to  *  w 


O 


Add  a  new  SQL  database  to  your  project. 

In  die  Solution  Explorer,  right-click  the  Contacts  project, 

select  Add,  and  then  choose  New  Item.  Choose  the  SQL 
1  )atabase  icon,  and  name  it  Contactl )B.mdf. 


This  file  is  our 
database 


ContactDB.mdf 


: . * . : 

I  Pick  the 
;  right  icon  for 
I  the  version 
|  you're  using  I 
I  Choose  SQL  j 
;  Database  if 
;  you're  using 
i  Visual  Studio  j 
i  Express  2005  i 
I  and  Service-  | 
i  Based 
i  Database  if 
j  you’re  using 
!  2008. 


1  Terrp  fates: 

33 

Visual  Slutfto  totaled  templates 

-g 

The  SQL. 

B 

About  Box 

i 

Application 

Coriftgurat). 

4 

Application 

Manifest  fab 

a 

Assenti  fy 

Information  Fite 

a 

Class 

£ 

Code  File 

££ 

DataSet 

Database  ^or 
or>W  «  7ou 

have  SQL- 

m 

4 

L A 

U 

H 

*  / 

Tnyrew  installed 
Flif  back  to  the 
kUVMt  if 

'you’re  mot  wre 
how  to  do  this 

Veuatoor 

interface 

ur*3  ®  SQL 
Classes 

local  Database 

MW  Parent 
Form 

Fescirces  Fdo  1 1 

\d 

Settr^F* 

ii 

Text  File 

i 

User  Control 

eu 

User  Cant’d 
(WPF) 

Wrttaw  Form 

X 

j 

XM  File 

zlZ? 

An  ewpty  SQL  Server  detabeae  far  servce-baaed  (Ui  acc «m 
Name~  ContactDB  rdf 


Add  ~~|  (  Cancel  ) 


Q  Cancel  the  Data  Source  Configuration  Wizard. 

For  now,  we  want  to  skip  configuring  a  data  source,  so 
click  the  Cancel  button.  We'll  come  back  to  this  once 
we’ve  set  up  our  database  structure. 


Q  View  your  database  in  the  Solution  Explorer. 

Co  to  the  Solution  Explorer,  and  you’ll  see  that 
ContactDB  has  been  added  to  the  file  list.  Double  click 
ContactDB.mdf  in  the  Solution  Explorer  and  look  at  die 
left  side  of  your  screen.  The  Toolbox  has  changed  to  a 
Database  Explorer. 


If  you’re  not  using 
the  Express  edition, 
you’ll  see  “Server 
Explorer”  instead  of 
“Database  Explorer”. 


The  Visual  Studio  2008  Professional 
and  Team  Foundation  editions  don't 
have  a  Database  Explorer  window. 
Instead,  they  have  a  Server  Explorer 
window,  which  does  everything  the 
Database  Explorer  does,  but  also  lets 
you  explore  data  on  your  network. 
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The  IRE  created  a  database 

When  you  told  the  IDE  to  add  a  new  SQL  database  to 
your  project,  the  IDE  created  a  new  database  for  you.  A 
SQL  database  is  a  system  that  stores  data  for  you  in  an 
organized,  interrelated  way.  The  IDE  gives  you  :tll  the 
tools  you  need  to  maintain  your  data  and  databases. 

Data  in  a  SQL  database  lives  in  tables.  For  now,  you 
can  think  of  a  table  like  a  spreadsheet.  It  organizes  your 
information  into  columns  and  rows.  The  columns  are  the 
data  categories,  like  a  contact’s  name  and  phone  number, 
and  each  row  is  the  data  for  one  contact  card. 


NET  Visual  .NET 
Objects  database 

Objects 


©-» 

i'k- 


Pata  Storage  Pepioywent 
Package 


»¥ 

Ir*  I  | 


* 


'/at  are  Here 


Your  data's  stored  I*  a 
table  with  tolun^  and 

rows,  like  in  a  spreadsheet 


A  SQL  data  base  stores  your 
data  aod  has  information  about 
how  it  s  structured  and  SQL 
code  to  help  you  access  it. 


Tables 


Stored  procedures  are 
statements  that  let  you 
work  with  your  data  easily. 


SQL  is  its  own  language 


SQL  stands  for  Structured  Query  Language. 

It’s  a  programming  language  for  accessing  data  in 
databases.  It’s  got  its  own  syntax,  keywords,  and 
structure.  SQL  code  takes  the  form  of  statements 
and  queries,  which  access  and  retrieve  the  data. 

A  SQL  database  can  hold  stored  procedures, 
which  are  a  bunch  of  SQL  statements  and  queries 
that  you  are  stored  in  the  database  and  can  be  run 
at  any  time.  Die  IDE  generates  SQE  statements 
and  stored  procedures  for  you  automatically  to  let 
your  program  access  the  data  in  the  database. 

^ - [note  from  marketing  Can  we  $et  a  plu$ 

for  'Head  First  SQL’  in  here?3 


The  SQL.  database  is  in  this  file 
We’re  just  about  to  define  tables 
and  data  (or  it,  and  all  of  that 
will  be  stored  in  here  too 


ContactDB.mdf 


you  are  here  ► 
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data  storage  made  easy 


Creating  the  table  for  the  Contact  List 


We  have  a  database,  and  now  we  need  to  store  information 
in  it.  But  our  information  actually  lias  to  go  into  a  table,  the 
data  structure  that  databases  use  to  hold  individual  bits  of 
data.  For  our  application,  let’s  create  a  table  called  “People” 
to  store  all  the  contact  information: 


©  Add  a  table  to  the  ContactDB  database. 

Right  click  on  Tables  in  the  Database  Explorer,  and  select 
Add  New  Table.  This  will  open  up  a  window  where  you  can 
define  the  columns  in  the  table  you  just  created. 


Database  Explorer 


GD  jl  % _ 

a  cP  Data  Connections 
S  [jj  ContactDB. mdf 

9  Gi  Database  Diagrams 


±J 

A 

* 

t 


F2  Views 


CM  Types: 


a 

Acid  New  Table  H 

3 

& 

New  Query 

Refresh 

Properties 

Now  we  need  to  add  columns  to  our  table.  First,  let’s  add  a 
column  called  Contact  ID  to  our  new  People  table,  so  that 
each  Contact  record  has  its  own  unique  ID. 

©  Add  a  ContactID  column  to  the  People  table. 

Type  “ContactID”  in  the  Column  Name  field,  and 
select  Int  from  the  Data  Type  dropdown  box.  Be  sure  to 
uncheck  the  Allow  Nulls  checkbox. 

Finally,  let’s  make  this  the  primary  key  of  our  table. 
Highlight  the  ContactID  column  you  just  created,  and 
click  the  Primary  Key  button.  T  his  tells  the  database 
that  each  entry  will  have  a  unique  primary  key  entry. 


a(  $  )«g  go  n  n 

* 

This  is  the  primary  Key  button  A  primary  key  helps 
your  database  look  up  records  quickly 


tJieroictre  np 

Dumb  Questions 


What's  a  column  again? 


Q: 

A. 

r\’  A  column  is  one  field  of  a  table 
So  in  a  People  table,  you  might  have  a 
FirstName  and  LastName  column.  It  will 
always  have  a  data  type.  too.  like  String  or 
Date  or  Bool. 

Qj  Why  do  we  need  this  ContactID 
column? 

It  helps  to  have  a  unique  ID  for  each 
record  in  most  database  tables.  Since 
we  re  storing  contact  information  for 
individual  people,  we  decided  to  create  a 
column  for  that,  and  call  it  ContactID 


Q: 


Yj  What's  that  Int  from  Data  Type 
mean? 

The  data  type  tells  the  database  what 
type  of  information  to  expect  for  a  column. 
Int  stands  for  integer,  which  is  just  a  whole 
number.  So  the  ContactID  column  will  have 
whole  numbers  in  it. 


Q: 


_  This  is  a  lot  of  stuff.  Should  I  be 
getting  all  of  this? 

No.  it's  OK  if  you  don't  understand 
everything  right  now.  Focus  on  the  basic 
steps,  and  we  ll  spend  a  lot  more  time  on 
databases  in  the  later  chapters  of  the  book 
And  if  you're  dying  to  know  more  right  away, 
you  can  always  pick  up  Head  First  SQL  to 
read  along  with  this  book. 
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© 


.NET  Visual 
Objects 


Tell  the  database  to  auto-generate  IDs. 

Since  Gontacill  )  is  a  number  for  the  database,  and  not 
our  users,  we  can  tell  our  database  to  handle  creating  and 
assigning  IDs  for  us  automatically.  That  way,  we  don’t  have 
to  worry  about  writing  any  code  to  do  this. 

In  the  properties  below  your  table,  scroll  down  to  Identity 
Specification,  click  the  +  button,  and  select  Yes  next  to  the 
(Is  Identity)  property: 


.NET  Pata  Storage  Peploywewt 

Patabate=^l  Package 


'/at  .tie  Ifere 


This  window  «  r*  wse 

to  defme  y°ur  table 

the  data  it  Will  store _ _ 

^  dbo.Tdblel:  T...0NTACTD6.M0F)*  Stat  Page 

(  ^  Cokmn  Name  Data  Type 


Ot  E-  j'-vi-r- 
Alow  Nils 


Forml.resx  Forml.cs  Forml.cs  [Design] 


11?  ContactID 


mt 


Cotimn  Properties 


::  ii 


■  DTS-publtshed 

0  Full-text  Specification 

I  Has  Non-?  ji.  -  ;  .bscnter 

□  Identity  Specification 


(Is  Identity) 


Identity  Increment 
Irlnnhi  ..■>  • 


No 

No 

|nT~ 

yes 

Ino 


It’s  important 
.that  yo«  leave  this 
unchecked  Since 
the  primary  key  is 
the  main  way  your 
program  will  locate 
records,  it  always 
needs  to  have  a 
value 


ro 

^kis  will  n,ake 

JI  that  the 
Contact/D 

•field  updates 
automatically 
'"kenevcn  a  new 
'KLard  is  added. 


you  are  here  » 
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let's  table  this  discussion 


The  blanks  on  contact  card  are 
columns  in  our  People  table 

Now  that  you've  created  a  primary  key  for  the  table,  you  need 
to  define  all  of  the  fields  your  going  to  uack  in  the  database. 
Each  field  on  our  written  contact  card  should  become  a 
column  in  the  People  table. 


Name:  Laverne 
Company:  YiZ  industries 


Telephone:  <aia>SSS-8ia9 

Email:  Laverne.S.mitri^yEindustnescorn 

Client: -/es  Last  call:  OS/afe/cn 


w 

Iz  efh  ***»•  we  to  store  data, 

add  rhone  email 

tKc  last  time  she  was  called 


,  f 


What  kinds  of  problems  could  result  from  having 
multiple  rows  stored  for  the  same  person? 
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Now  that  you’ve  created  a  People  table  and  a  primary  key  column,  you  need  to  add  columns  for  all  of  the  data 
fields.  See  if  you  can  work  out  which  data  type  goes  with  each  of  the  columns  in  your  table,  and  also  match  the 
data  type  to  the  right  description. 


Column  Name 


Data  Type 


List  Call 


int 


Name 


Kit 


Contact  ID 


nvarcKar(SO) 


Client? 


ciatctiinc 


Description 

This  type  stores  a  date 
and  time 


A  Boolean  true/ false  type 


A  string  of  letters, 
numbers  and  other 
characters  with  a 
maximum  length  of  50 


A  whole  number 


you  are  here  ► 
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it’s  just  my  type 


Now  that  you've  created  a  People  table  and  a  primary  key  column,  you  need  to  add  columns  for  all  of  the  data 
fields.  See  if  you  can  work  out  which  data  type  goes  with  each  of  the  columns  in  your  table,  and  also  match  the 
data  type  to  the  right  description. 


Column  Name  Data  Type  Description 
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Finish  building  the  table 

Go  hark  to  where  you  entered  the  ContactID  column 
and  add  the  other  five  columns  front  the  contact  card. 
Here's  what  your  database  table  should  look  like 
when  you’re  done: 


.NET  Visual  .NET  data  Storage  Peploywent 

Oblecis  database  ==•!  Package 


y©U  are  liere 


Click  on  the  Save  button  on  the  toolbar  to  save  your  new  table.  You'll  be 
asked  for  a  name.  Call  it  “People”  and  click  OK. 


5S  the  **«e>t 

,i  untl  tM*  sU?  ^ 
t  ar  r'a"'e 


you  are  here  ► 
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map  it  out 


flagrant  your  data  so  your 
application  can  access  it 

Once  you’ve  created  your  database  and  tables,  you  have  to  let  your 
application  know  about  it.  That’s  where  a  database  diagram  conies  in. 

A  database  diagram  is  a  simple  description  of  your  table  that  the 
Visual  Studio  IDE  can  use  to  work  with  the  table.  It  also  lets  the  IDE 
automatically  generate  SQL  statements  to  add,  change,  and  delete 
rows  in  the  table. 

Create  a  new  database  diagram. 

Go  to  the  Database  Explorer  window  and  right-click  on  the 
Database  Diagrams  node.  Select  Add  New  Diagram. 


Let  the  IDE  generate  access  code. 

Before  you  tell  the  IDE  about  your  specific  table,  it  needs  to 
create  some  basic  stored  procedures  for  interacting  with  your 
database.  Just  click  Yes  here,  and  let  the  IDE  go  to  work. 


o 


o 


fctrfabase  Ecpkarer  «  0  X 

dboPeopl. 

3L  % 

1 

a  Data  Connections 

►  Contact!* 

is  4  ContactDe.mdf 

I 

Ik  rj  Tables  Add  New  Dwgram  1 

*  J  Stored  Procedure  3 

ik  a  Functions  Propertks 

Ik  Types 

it  As»fnt*e* 

t 

Remember,  -these  options 
are  all  under  ContadtDB, 
so  they  all  apply  to  that 
specific  database 


o 


Select  the  tables  you  want  to  work  with. 

Select  the  People  table  from  the  window  that  pops  up,  and 
click  Add.  Now  the  IDE  is  ready  to  generate  code  specific 
to  your  table. 


Wed  procedures 

fhat  r*  u 
b  i  -W.th  the 
to  mteratt^  ,  d 

database  y~  treaU 


^  ***  Abases 

I  show  up  as  an 
'nhrY  on  this  window 


26  Chapter  1 


get  productive  with  c# 


Peploymciit 

Package 


'/ou  are  flew 


Name  your  diagram  PeopleDiagram. 

Select  File>Save  Diagram.  You’ll  be  asked  to  name  your 
new  database  diagram.  Call  it  PeopleDiagram,  and  you’re 
all  set. 


The  database  diagram  <s 
shown  here  visual^/  It  *  a 

very  simple  representation 

your  table 


If  you  had  any  other 
tables  in  the  database  you 
wanted  diagrammed,  they 
would  appear  here,  too 


|(  you’re  using  l/isual 
Studio  100$,  select 
p.le>Save  AH  instead 


dbo.Diagraml_.NTACTDB.MDF)*  dbo. People:  T...ON 


9 

ContactID 

Name 

Company 

Telephone 

Email 

Client 

LastCall 

|Th.s  «  t 

daU^%heT^tlt)  «■-»* 

^^^SandVisb^a" 

your  primary  *  y 

the  columns  in  t 


A  database  diagram  describes  your  tables 

to  tke  Visual  Studio  IDE.  Tke  IDE  tken 

uses  tke  database  diagram  to  auto-generate 
code  to  work  witk  your  database. 
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adding  your  data 


Insert  your  card  data  into  the  database 

Now  you’re  ready  to  start  entering  cards  into  the  database. 

Here  are  some  of  the  boss’s  contacts — we’ll  use  those  to 
set  up  the  database  with  a  few  records. 


© 


© 


Expand  Tables  and  then  right  click 
on  the  Pe<  >ple  Table  in  the  Database 
Explorer  (or  Server  Explorer)  and 
select  Show  Table  Data. 


Once  you  see  the  Table  grid  in  the 
main  window,  go  ahead  and  add  all  c 
the  data  below.  (You’ll  see  all  NULL 
values  at  first  just  type  over  them 
when  you  add  your  first  row.  And 
ignore  the  exclamation  points  that 
appear  next  to  the  data.)  You  don’t 
need  to  fill  in  the  ContactID  column, 
that  happens  automatically. 


:  :*er  «9x| 

dbo.Peop 

j  People  I 

a  Data  Connections 

<3 

onr 

B  Ub  ContactDB.mdf 

B  SJ  Database  Diagrams 

Name  1 

a  CM  Tables 

."Mf* 

a  3 1339 _ U 

TelepliB 

Q|  Vfew5 
CM  Stored  Procr 
CM  Functions  ! 
CM  Synonyms 
CM  Types 
Gl  Assemblies 


J 


Add  New  T  able 
Add  New  Trigger 
New  Query 
Open  Table  Defrttion 
Show  Table  Data 


Your  job  is  to  enter  the  data 
•from  all  si*  of  these  cards 
into  the  People  table 


piapg( 


,  .  ■’  Ui  Nielson 

„  o<  a\'e  Name. 

T'fl*  Company-  ' 

■-  telephone:  W9SS6-*-® 

1“'  Ema  _  Las* ca"’ 05/04/ 

Client:  — 


Name:  Lloyd  Jones 
Company:  G>lacK  fcox  >oc. 

Telephone:  (-ti8)S5S-5(o^8 

Email:  l  Jones(^b\acKboxvoC..COfrt 

Client:  Last  call:  os/a<o/oi 


Paper  oomppnjr 


Name:  Lucinda  Encson 
Company:  ericson  events 
Telephone  (aia)sss-9sa3 
Email:  Lucy@er  icsoneven-ls.inSo 

Client:  mo  Last  call:  os/n/oi 
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Name:  rrvrtt  FranKs  ( 

Company:  XYE  industries^ 
Telephone:  {aia)sss-8lias 
Email:  matt.FranKs@xy2industr iescom 
Client:  yfes  Last  call:  os/ato/cn 


V 


Name:  Sarah  kaiter  ’’•W”’*'*  r  company 

Company:  natter,  Giddle,  and  S>to$t 


Telephone:  (W4)sss-Sfc,4l 
Email:  S>arah(3nGS.or<j 

Client:  no  Last  call:  la/io/os 


V  ff 


Laver ne  Smith 


Company:  XY2  Industries 

Telephone:  (aia)sSS-0aQ 

Email:  Laverne.SmitW?Xij2industrtescx3m 

Client:  yes  Last  call:  os/ab/oi 


1 _ | 


Once  you've  entered  all  six  records, 
select  Save  All  from  the  File  menu 
again.  That  should  save  the  records 
to  the  database. 


"Save  AH"  the  IDE  to  save 

everything  in  your  a?fl.cat.o. 
That's  different  fro*.  "Sa^ 
just  saves  the  file  you're  working 


which 


tJierejare  no 

Dumb  Questions 


n* 

So  what  happened  to  the  data  after  I  entered  it?  Where 
did  it  go? 

The  IDE  automatically  stored  the  data  you  entered  into  the 
People  table  in  your  database.  The  table,  its  columns,  the  data 
types,  and  all  of  the  data  inside  it  is  all  stored  in  the  SQL  Server 
Express  file,  ContactDB.mdf.  That  file  is  stored  as  part  of  your 
project,  and  the  IDE  updates  it  just  like  it  updates  your  code  files 
when  you  change  them. 


cv 

V^.  Okay,  I  entered  these  six  records.  Will  they  be  part  of 
my  program  forever? 

Yes.  they’re  as  much  a  part  of  the  program  as  the  code 
that  you  write  and  the  form  that  you’re  building.  The  difference 
is  that  instead  of  being  compiled  into  an  executable  program, 
the  ContactDB.mdf  file  is  copied  and  stored  along  with  the 
executable.  When  your  application  needs  to  access  data,  it  reads 
and  writes  to  ContactDB.mdf,  in  the  program's  output  directory. 


, base  and  your-  program 

£pUSe  7th  the  Code  the 
IPt  generated  -for  you. 


'  0 

ContactDB.mdf 


you  are  here  ► 
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the  data’s  all  in  there 


Connect  your  form  to  your  database 
objects  with  a  data  source 


We’re  finally  ready  to  build  the  .NET  database  objects  that  our 
tbrm  will  use  to  talk  to  your  database.  VVe  need  a  data  source, 
which  is  really  just  a  collection  of  SQL  statements  your  program 


will  use  to  talk  to  the  GontactDB  database. 


Go  back  to  your  application’s  form. 

Close  out  the  People  table  and  the  GontactDB  database 
diagram.  You  should  now  have  the  Form  1  .cs  (Design]  tab  visible. 


data  arid  and  the  d.a< 
jet  back  io  your  £ 


People:  Query. 

.ONrACTDB.MDF)  dbo.Pec(*eOi  ,,OMTACIDe.MDC)  dbo. People:  T...0NTACTD6.M0F)  Start  Page  Otiect  Browser 

Contact  ID 

Name 

Company 

Telephone 

Email 

Che nt 

LastCal 

1 

Lloyd  3ones 

Black  Box  Inc 

718555638 

ljones<g>blackbox. . . 

True 

5/26/2007  12:0.. 

2 

Luanda  Eric  son 

Encson  Events 

2125559523 

Lucy^encsonev. . . 

False 

5/17/2007  12:0.. 

3 

Liz  Nelson 

JTP 

4195552578 

lznefconflPitp.org 

True 

3/4/200612:00:. 

4 

Matt  Franks 

XYZ  Industries 

2125558125 

matt.fr  anksflpxy... 

True 

5/26/2007  12:0.. 

5 

'r  V.  •  h’-r 

Kafter,  Riddte,  a... 

6145555641 

sarah  ka*er#K... 

False 

12/10/2006  12:.. 

6 

Laverne  Smith 

XYX  Industries 

2125558129 

Laverne. Sfrittk., 

True 

5/26/2007  12:0.. 

»* 

MAI 

NULL 

NULL 

NULL 

NULL 

NULL 

NULL 

on 

'otm» 


O 


Add  a  new  data  source  to  your  application. 

This  should  be  easy  by  now.  Click  the  Data  menu,  and  then 
select  Add  New  Data  Source...  from  the  drop  down. 


Fte  Edt  View  Project  Buid  Debug 

|  Data  Format  Tools  Window  Help 

>4  l.  i  J  7  w  _i  . !,j 

a 

Show  Data  Sources  SWt+AK+O 

J3  _J  •  j-  A  J  -0 

a 

Preview  Data. . . 

Database  Explorer  w  0  X 

j 

Add  New  Data  Source. . . 

_ 

S  JJ  Data  Connections 

n 

—  .ww  -wwi  LI 


Cj  Database  Diapams 
Cd  tables 
m  3  People 
lJ  Views 

CJ  Stored  Procedures 
ui  Functions 
lS  Synonyms 
[3  Types 
Ha  Assembles 


fesy  Forml.cs 


Creatino  will  handle  all  the 

ctca^tions  between  your 

•form  and  your  database 
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NET  Visual 


NET 


Pata  Storage  Peploywent 
Package 


m 


Configure  your  new  data  source. 

Now  you  need  lo  setup  your  data  source  to  use  the  ContactDB 
database.  Here’s  what  to  do: 

*  Select  Database  and  click  the  Next  button. 

*  Click  Next  in  the  “Choose  your  Data  Connection” 

screen.  . 

*  Make  sure  the  Save  the  connection  checkbox  is  checked  . 
in  the  “Save  the  Connection”  screen  that  follows  and  4/ 
click  Next. 

*  In  the  “Choose  Your  Objects"  screen,  click  the  Table 
checkbox. 

*  In  tile  Dataset  Name  field,  make  sure  it  says 
“ContactDBDataSet”  and  click  Finish. 

ffox  your  -for •*>  tan  use  the  data 
sourte  to  inter  a  tt  with  the 


tattDB  database 


tonnect  your 
"tw  data  source  w,tk 

hP7jf0^  ih  the 

ContactDB  database 


ContactDBDataSet. 


't 

Were  s  your  existing  -for*,. 


ContactDB.mdf 


ContactDBDataSet. 
Designer.es 

These  -Piles  are  what  s 
generated  by  the  data 
sourte  you  just  setuf 


This  -file  is  your  database 


you  are  here  ► 
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bind  it  all  together 


Add  database-driven  controls  to  your  form 


Now  we  ran  go  hark  to  our  form,  and  add  some  more  controls.  But 
these  aren’t  just  any  controls,  they  are  controls  that  are  bound  to  our 
database,  and  the  columns  in  the  People  table.  That  just  means  that 
a  change  to  the  data  in  one  of  the  controls  on  the  form  automatically 
changes  the  data  in  the  matching  column  in  the  database. 


Here’s  how  to  create  several  database-driven  controls: 


li  took  a  little  work,  but  now  we're 

badk  -to  f0\m*  objects  that 

interact  With  our  data  Storage 


Select  the  data  source  you  want  to  use. 

Select  Show  Data  Sources  from  the  Data  pull  down  menu.  This 
will  bring  up  the  Data  Sources  window,  showing  the  sources  you 
have  setup  for  your  application. 


Toolbo>  ^Database...  ^  Data  Sources 


I 


4 

^is  window  shows  vou  j||  J.  .  , 

TZdt  °h,y  ?  °^Vtt 


|£  you  don’t  see  this  tab, 
seleet  "Show  Data  Sources 
■fro**  the  Data  menu 


You  can  also 
look  for,  and 
click  on,  the 
Data  Sources 
tab  along  the 
bottom  of  your 
Database 
Explorer  window. 


Q  Select  the  People  table. 

Under  the  ContactDBDataSet,  you  should  see  the  People  table 
and  all  of  the  columns  in  it.  If  you  don’t  see  the  columns,  click 
the  arrow  for  the  drop  down  menu,  and  seleet  Details. 


Data  Sources 


ia?j  ContactDBDataSet 

a  pi 

tab!  ConEactlD 
W  Name 
taM;  Company 
W  Telephone 
■H  Email 
0  Client 
|||  LastCall 


This  is  "the 

little  arrow  you 
should  tlitk  on- 


fields 

F*  *****  should 
show  up  here. 
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NIT  v  i  .NET  fata  Storag*  Peploy'tiei't 


'/feU  ure  Rete 


o 


Create  controls  that  bind  to  the  People  table. 

Drag  and  drop  the  People  table  onto  your  form.  You  should  see 
controls  appear  lbr  each  column  in  your  database.  Don’t  worry 
too  much  about  how  they  look  right  now;  just  make  sure  that 
they  all  appear  on  the  form. 

: . * . . . j . s . : 

i  If  you  accidentally  click  out  of  the  form  you’re  working  on,  you  ; 
;  can  always  get  back  to  it  by  clicking  the  “Forml  cs  [Design]" 

!  tab,  or  opening  Forml  .cs  from  the  Solution  Explorer 


Start  Page  Object  Browww  Forml.fMx*  Forml.  cj*  Form  lx*  [Dr«mnP 


The  IDE 
treates  this 
toolbar  for 
navi^atinj 
through  the 
People  table. 


c»W  ►  >1  QiJ 

0- 


Contact  O  • 

None  4  ~ 

Company  0 
Tetectwng  I 

Emarf  ■ 

deni  O  chockBoid 


v 

"1 

*  • 


A 


Last  Cal 


//her.  you  draped 
the  P eofle  table 
onto  the  W,  a 

Control  'was  treated 
for  eath  tdun.n  in 
the  table 


These  won’t  v 

/ s^contactMOotaSet  1  peopkawjngSoji 

ShOVJ  u Y  OY\  S 

your  form,  but  ^ 

represent  the 
data  set  the 
|D£  treated  to 
interact  with 
the  People  table 
and  ContattDB 
database 


fcipeogUUbi eAdwtei  J.  V  p«w*arw*^N» 


^he  til 


4 


IKis  Lo^'tis  the 

+orn.  to  your  Peop|e  table. 


I 

This  adapter  allows  your 
eontrols  to  interatt 
with  £$L  Commands 

that  the  IDE  and  data 

sourte  generated  for  you 


indina 
hJv'3aton 
<onn«ts  the 

?+*  Wrols 
^  iab/e. 
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make  it  pretty 


(rood  programs  arc  intuitive  to  use 

Right  now,  the  form  works.  But  it  doesn’t  look  that  great.  V’our 
application  lias  to  do  more  than  be  functional.  It  should  be 
easy  to  use.  With  just  a  few  simple  steps,  you  can  make  the 
form  look  a  lot  more  like  the  paper  cards  we  were  using  at  the 
beginning  of  the  chapter. 


(T)  Line  up  your  fields  and  labels. 

Line  up  your  fields  and  labels  along  the  left  edge  of 
the  form.  Your  form  w  ill  look  like  other  applications, 
and  make  your  users  feel  more  comfortable  using  it. 


O" 


Ovr  form  would 
be  more  intuitive 
if  it  looked 
a  lot  like  the 
dontadt  tard 


Name:  Laverne  Vncth 
Company:  X'/E  tndosfr ies 
Telephone:  (aia)SSS-8iaP 
Email:  cav^ne.S^dh(5xyEitvAostries&orri 
Client:  -ye*  Last  call:  os/ato/cn 


Blue  lines  v«M  show 
uf  on  the  form  as 
you  dra^  dontrols 
around  They're 
there  to  help  you 
line  the  fields  up 


LM  4  ]  0  OMO> 

Contact  ID 

Name 

1  Company 

Telephone 

=□ 

Emai 

Clent:  (Q  checkfioxl 

O - O 

Ci8(  Cal  Sunday  .  Al*  v 

6 

Change  the  Text  Property  on  the  Client  checkbox. 

When  you  first  drag  the  fields  onto  the  form  your  Client 
Checkbox  will  have  a  label  to  the  right  that  needs  to  be 
deleted.  Right  below  the  Solution  Explorer,  you’ll  see  the 
properties  window.  Scroll  down  to  the  Text  property  and 


delete  the  “checkbox  1  ”  label. 


tkentCheckBox  System. Windows. Form*. Che  • 

it  i4i  nsi  /  si. 


Image 

1  1  (none) 

ImageAlgn 

MddeCenter 

Imagelndex 

1  1  (none) 

Imagekey 

1  1  (none) 

Imagetlst 

(none) 

RightToteft 

No 

|  checkBoxll  <- 

TextAign 

Mddeleft 

T  extlmaqeP  elation 

Overlay _ 

Delete  this  word  to  make 

Athe  label  50  away 


Text 

The  text  associated  w*h  the  control. 
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'/oil  lire  Here 


NtT  Visual  .NET  Vata  Storage  Veploymenf 

Objects  database  =•;  Package 


Make  the  application  look  professional. 

You  can  change  tin*  name  of  the  form  by  clicking  on  any  space 
within  the  form,  and  finding  the  Text  property  in  the  Properties 
window  of  your  IDE.  Change  the  name  of  the  form  to 
“Objectville  Paper  Co.  -  Contact  List.” 

You  can  also  turn  off  the  Maximize  and  Minimize  buttons  . 
in  this  same  window,  by  looking  for  the  MaximizeBox  and 
MinimizeBox  properties.  Set  these  both  to  False. 


The  reason  you  want  to  turn 
ore  the  Maximize  button  is 
that  maximizing  your  -form 
won  t  change  the  positions  of 
the  Controls,  so  it'll  look  weird. 


"he  Properties 

s*b-  A 

^e  lower  rV^vt  P  * 
your  ID^ 


Cktmk 
a  Font 
ForeCator 
FomfiorderStyte 
|  PgjhtToi*#t 

BightTcAefttavoot 


iJ^WaC'Iorscr 

Tad 

The  tot  aHcotted  vdth  the  contrd 


r  Text  property 
to'brols  the  heading  on 
your  form’s  title  bar 


j  If  you  don’t  have  a  Properties  window,  you  can  turn 

i  it  on  by  selecting  it  from  the  View  drop-down  menu 

: 


A  good  application  not  only  works,  but  is  easy 
to  use.  It’s  always  a  good  idea  to  make  sure  it 
kekaves  as  a  typical  user  would  expect  it  to. 


you  are  here  ► 
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okay,  one  last  thing... 


Test  drive 


Okay,  just  one  more  thing  to  do...  run  your  program 
and  make  sure  it  works  the  way  you  think  it  should!  Do  it 
the  same  way  you  did  before — press  the  F5  key  on  your 
keyboard,  or  click  the  green  arrow  button  ►  on  the  toolbar 
(or  choose  “Run”  from  the  Debug  menu). 

You  can  always  run  your  programs  at  any  time,  even  when 
they're  not  done — although  if  there’s  an  error  in  the  code, 
the  IDE  will  tell  you  and  stop  you  from  executing  it. 


l0  -i  _  u  "  «»*  coimev 

£  ^  so  you 

^  "’ove  «  ^  ne*f»L. 
✓ 


These  tontvols 

let  Y«*  ?a5e 
through  the 

di«ere*t  retords 

i*  the  database 


Well  spend  more  time 
on  this  in  the  ncnt 
Chapter. 


■d 


Objectville  Paper  Co.  -  Contact  List 


:  H 


1 


of  6 


I  ►  H  J.»  X  iA 


Contact  ID:  Q 
Name: 
Company: 


Email: 

Client:  0 


1  1 

Lloyd  Jones 

V 

Black  Box  Inc 

718555638 

ObJ*c4vi 


ljone$@blackboxinc.  com 


lie  Paper  company 


Last  Call:  Saturday  ,  May  26.2007  v 


The  IPE  builds  first,  then  runs. 

When  you  run  your  program  in  the  IDE  it  actually  does  two  things.  First  it 
build  s  your  program,  then  it  executes  it.  This  involves  a  few  distinct  parts. 
It  compiles  the  code,  or  turns  it  into  an  executable  file.  Then  it  places  the 
compiled  code,  along  with  any  resources  and  other  files,  into  a  subdirectory 
underneath  the  bin  (older. 

In  this  case,  you'll  find  the  executable  and  SQL  database  file  in  bin/ 
debug.  Since  it  copies  the  database  out  each  time,  any  changes  you 
make  will  be  lost  the  next  time  you  run  inside  die  IDE.  But  if  you  run  the 
executable  from  Windows,  it'll  save  your  data  until  you  build  again,  at 
which  point  the  IDE  will  overwrite  the  SQL  database  with  a  new  copy  that 
contains  the  data  you  set  up  from  inside  the  Database  Explorer. 


Building  your 
program 
overwrites 
the  data  in 
your  database. 
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How  to  turn  YOUR  application 
into  EVERYONE'S  application 

At  this  point,  you’ve  got  a  great  program.  But  it  only  runs 
on  your  machine.  That  means  that  nobody  else  can  use  the 
app,  pay  you  lor  it,  see  how  great  you  are  and  hire  you... 
and  your  lxtss  and  customers  can’t  see  the  reports  you’re 
generating  from  the  database. 

C#  makes  it  easy  to  take  an  application  you’ve  created,  and 
deploy  it.  Deployment  is  taking  an  application  and  installing 
it  onto  other  machines.  And  with  the  Visual  C#  IDE.  you 
can  set  up  a  deployment  with  just  two  steps. 


.NET  Visual 
Objects 


.NET  _ 

Vatabase  ;===', 
Objects 


data  Storage  Veptoymewt 
Package 


0 


Qv^ 

m 

'/cit  are  fieri? 


O  Select  Publish  Contacts  from  the 
Build  menu. 


F*>  E*  View  Project  fk*l  )  Cebu]  Cieta  Format  Tools 

-I  L  £  J  1  ButdSokJbon  P 

J_J*  J  A  A  RobuMSokttm 

Data  Sources  Pubteh  Objectvle  Paper  Contact  List 


Building  “the  solution  just 

Copies  -the  -files  ho  your 
local  machine  Publish 
Creates  a  Setup  executable 
and  J  Configuration  file 
so  that  any  machine  Could 
install  your  program. 


OJust  accept  all  of  the  defaults  in  the 
Publish  Wizard  by  clicking  Finish. 
You'll  sec  it  package  up  your 
application  and  then  show  you  a 
folder  that  has  your  Setup.exe  in  it. 


you  are  here  ► 


37 


share  the  love 


(rive  your  users  the  application 

C  )nce  you’ve  created  a  deployment,  you’ll  have  a  new  (older 
called  publish/.  That  folder  has  several  things  in  it,  all 
used  for  installation.  The  most  important  for  your  users  is 
setup,  a  program  that  w  ill  let  them  install  your  program  on 
their  own  computers. 


This  is  ^eve  a"  ^ 

support^ 

,*staHer  are  sWd 


publish  •  Microsoft  Internet  Explorer  ^)[n|[>< 


File  Edt  view  Favorites  Tools  He£ 

O  T  y  Search  Folders  ITHl^ 

I  a  c  Apocuments  and  SetnngsVldmnrstratorVty  D  v  |  Q  Go  Lni;  * 


tws  {.le  t*  ’T3""' 

program  is 


Contacts.appIcatSon 

AppfcaOon  Manfest 
6  KB 


setup.exe 

Setup 


» 

"^hts  is  how  your 
use«  will  instil 
^he  program  on 

'their  Computers/ 


My  secretary  just  told  me  that  you’ve 
got  the  new  contact  database  working 
already.  Pack  your  bags— we’ve  got  room  on 
the  jet  to  Aspen  for  a  go-getter  like  you! 


■  There’s  just  one  more  thing 
you  can  jet  o£t  to  the  slopes,  though.- 
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You're  NOT  done:  test 
your  installation 

Before  you  pop  the  cork  on  any  champagne  bottles,  you  need 
to  test  your  deployment  and  installation.  You  wouldn’t  give 
anyone  your  program  without  running  it  first,  would  you? 

Close  the  Visual  Studio  IDE.  Click  the  setup  program, 
and  select  a  location  on  your  own  computer  to  install  the 
program.  Now  run  it  front  there,  and  make  sure  it  works  like 
you  expect.  You  can  add  and  change  records,  too,  and  thev‘11 
be  saved  to  the  database. 


.NET  Visual  .NET  Pata  $tora««  Peployweut 


’/oil  are  Here 


3  Wved  database. 


You  £<3n  use  the 
arrows  and  the 
k*t  field  to  swi^/h 
between  records. 


£jo  ahead  "•a** 
s owe  thanes 


/ou've  deployed 
it  so  this  -time, 


-they'll  stitk 


The 


Six  records 


initially  entered 
all  there. 


you 

are 


TEST  EVERYTHING! 

Test  your  program,  test 
your  deployment,  test  tke 
data  in  your  application. 
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super  fast! 


You  built  a  complete 
data-driven  application 

The  Visual  Studio  IDE  made  ii  pretty  easy  to  create 
a  Windows  application,  create  and  design  a  database, 
and  hook  the  two  together.  You  even  were  able  to 
build  an  installer  with  a  few  extra  clicks. 


.NET  Visual  .NET 
Objects  database -~ 

Objects  1“ 


data  Storage  Peplovseiit 
Package 


1 V 


03 

ft 


- 


From  (lib 

ifi  /"""x 

Name:  Lloyd  Jones 
Company:  GAacK  ftox  \nc. 

Telephone:  (ue)ssS-S<o38 

Email:  coones(?xb\acKbox\rvcxom 

Client: -fes  Last  call:  OS/a<o/cn 


"  Objectville  Paper  Co.  -  Contact  List 


«  1 


to  this 


L-L 


1 


0t6  It  HIhOS.  A 


Contact  ID: 
Name 
Comparer 
T  elephone 
Email: 
Cient:  0 


r\ 


Lloyd  Jones 

y— 

Black  Box  Inc 

1 71 8555638 

ljones@blackboxinc.com 

Last  Cal: 

Satuiday 

May  26. 2007  *8  | 

in  no  time  flat. 


The  power  ol  Visual  C#  is  that  you  can  tjuickly 
get  up  and  running,  and  then  locus  on  your 
what  your  program  s  supposed  to  do...  not  lots 
ol  windows,  buttons,  and  SQL  access  code. 
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CSharpcross 

Take  some  time  to  sit  back  and  exercise  your  C#  vocabulary  with 
this  crossword;  all  of  the  solution  words  are  from  this  chapter. 


Across 

I.  When  you  do  this  from  inside  the  IDE,  it's  called  "debugging" 

3.  The _ explorer  is  where  you  edit  the  contents  of  your 

SQL  tables  and  bind  them  to  your  program 

5  The  "About”  box  in  the  Contact  List  program  was  one  of  these 

6.  You  build  one  of  these  so  you  can  deploy  your  program  to 
another  computer. 

9  An  image,  sound,  icon  or  file  that's  attached  to  your  project  in 
a  way  that  your  objects  can  access  easily. 

II.  Before  you  can  run  your  program,  the  IDE  does  this  to 
create  the  executable  and  move  files  to  the  output  directory. 

14  The  database _ gives  the  IDE  information 

about  your  database  so  it  can  generate  SQL  statements 
automatically 

16  The _ explorer  in  the  IDE  is  where  you'll  find  the 

files  in  your  project 

17.  Drag  one  of  these  objects  onto  your  form  to  display  an 
Image. 

1 8  A  stored _ is  a  way  for  a  SQL  database  to 

save  queries  and  statements  that  you  can  reuse  later. 


Down 

2.  What's  happening  when  code  is  turned  into  an  executable 
4  A  SQL  database  can  use  many  of  these  to  store  its  data 

7.  What  you  change  to  alter  the  appearance  or  behavior  of 
objects  on  your  form 

8.  What  you're  doing  to  your  program  when  you  run  it  from 
inside  the  IDE. 

10  Every  row  in  a  database  contains  several  of  these,  and  all  of 
them  can  have  different  data  types. 

12.  Before  you  start  building  any  application,  always  think  about 

the  users  and  their _ . 

1 3  You  drag  objects  out  of  this  and  onto  your  form 
15.  When  you  double-clicked  on  a  visual  control,  the  IDE 
created  this  for  you  and  you  added  code  to  it 


you  are  here  > 
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crossword  solution 


CSharpcross  Solution 
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2  rts  fill  just  code 


4- 

*  Under  the  Hood  * 


You’re  a  programmer,  not  just  an  IDE-user. 

You  can  get  a  lot  of  work  done  using  the  IDE  But  there’s  only  so  far  it 
can  take  you.  Sure,  there  are  a  lot  of  repetitive  tasks  that  you  do  when 
you  build  an  application  And  the  IDE  is  great  at  doing  those  things  for 
you.  But  working  with  the  IDE  is  only  the  beginning.  You  can  get  your 
programs  to  do  so  much  more — and  writing  C#  code  is  how  you  do  it. 
Once  you  get  the  hang  of  coding,  there's  nothing  your  programs  can't  do. 


this  is  a  new  chapter 
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at  your  service 


When  you're  doing  this... 

Hie  IDE  is  a  powerful  tool  but  that’s  all  it  is,  a  tool  for  you  to  use.  Every  time 
you  change  your  project  or  drag  and  drop  something  in  the  IDE,  it  creates  code 
automatically.  It’s  really  good  at  writing  boilerplate  code,  or  code  that  can  be 
reused  easily  without  requiring  much  customization. 

Let’s  look  at  what  the  IDE  does  in  typical  application  development,  when  you’re... 


All  o(  -these  -tasks  have  to 
do  with  standard  actions, 
and  boilerplate  Code  Those 
are  the  things  the  IDE  is 

yeat  -for  helping  with 


Creating  a  new  Windows  Application  solution 

There  are  several  kinds  of  applications  the  IDE  lets 
you  build,  but  we’ll  be  concentrating  on  Windows 
applications  for  now.  Those  are  programs  that  have 
visual  elements,  like  forms  and  buttons. 


Make  sure  you  always  Create  a  Windows  Forms  Appkat 
project— that  tells  the  IDE  to  Create  an  empty  -form 
and  add  it  to  your  new  project. 


Cm, 

a  c  a  s  3 


kj  -j  •*!<..  ••  H4 


i  *  i  r”-  J 


Dragging  a  button  out  of  the  toolbox  and 
onto  your  form,  and  then  double-clicking  it 

Buttons  are  how  you  make  things  happen  in  your  form. 
We’ll  use  a  lot  of  buttons  to  explore  various  parts  of  the 
C#  language.  They’re  also  a  part  of  almost  every  C# 
application  you’ll  write. 


[  button  1  T 

V  j 


Setting  a  property  on  your  form 
The  Properties  window  in  the  IDE  is  a  really 
powerful  tool  that  you  can  use  to  change  attributes  of 
just  about  everything  in  your  program:  all  visual  and 
functional  properties  for  the  controls  on  your  form, 
attributes  of  your  databases,  and  even  options  on  your 
project  itself. 


The  FVope*-£ies  window  In  fkn  /r>c 

j-t  J  rally  „sy  TV  "5  « 


by  hand 


longer 


form  I  System.  wndows^or  ms  Perm 


■  SzeGrpSCyte 

AUtO  *  1 

StartPosition 

Wr.a:.«  !Ofaj'l. .  i 

Tag 

Otojer  tvtie  Pap*r 

TcpMost 

Fate 

1  Transparency*^  CD 

UseWatCurscr 

Fate  I 

Text 
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...the  IPE  does  this 


Every  time  you  make  a  change  in  the  IDE,  it  makes  a 
change  to  the  code,  which  means  it  changes  the  files  that 
contain  that  code.  Sometimes  it  just  modifies  a  few  lines, 
but  other  limes  it  adds  entire  files  to  your  project. 


...  the  IDE  creates  the  files  and 
folders  for  the  project. 


These  are  Created 

?  *7deTd  WW*  that 
Co«ta.r,s  the  basic  code  to 

ilreate  and  display  a  £>r 


ocm 


WindowsApplicationl 

.esproj 


Properties 


Forml  ,cs 


Forml 


Program.es 


...  the  IDE  adds  code  to  the  Forml.Designer.es  file  that  adds 
the  button  to  the  form,  and  then  adds  code  to  the  Forml.cs 
file  to  handle  the  button  click. 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


( 


The  IDE  knows  how  to  add  an  empty  method 
to  handle  a  button  click.  But  it  doesn't  know 
what  to  put  inside  it — that's  your  job. 


This  Code 
3dded  t, 

form /.£s 


Forml  .Designer.es 


Forml  .cs 


..  the  IDE  opens  the  Forml.Designer.es  file  and 
updates  a  line  of  code. 


you  are  here  ► 
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great,  the  "talk" 


Where  programs  come  from 

A  C#  program  may  start  out  as  statements  in  a  hunch  of 
files,  but  it  ends  up  as  a  program  running  in  your  computer. 
Here’s  how  it  gets  there. 


Every  program  starts  out  as  source  code  files 

You’ve  already  seen  how  to  edit  a  program,  and  how  the  IDE  saves  your  program 
to  files  in  a  folder.  Those  files  are  your  program  you  can  copy  them  to  a  new 
folder  and  open  them  up,  and  everything  will  be  there:  forms,  resources,  code,  and 
anything  else  you  added  to  your  project. 

You  can  think  of  the  IDE  as  a  kind  of  fancy  file  editor.  It  automatically  does  the 
indenting  for  you,  changes  the  colors  of  the  keywords,  matches  up  brackets  for  you, 
and  even  suggests  what  words  might  come  next.  But  in  the  end,  all  the  IDE  does  is 
edit  the  files  that  contain  your  program. 

The  IDE  bundles  all  of  the  files  lor  your  program  into  a  solution  by  creating  a 
solution  (.sin)  file  and  a  folder  that  contains  all  of  the  other  files  lor  the  program. 
The  solution  file  has  a  list  of  the  project  files  (which  end  in  .esproj)  in  the  solution, 
and  the  project  files  contain  lists  of  all  the  other  files  associated  with  the  program. 

In  tliis  book,  you’ll  be  building  solutions  that  only  have  one  project  in  them,  but 
you  can  easily  add  other  projects  to  your  solution  using  the  IDE's  Solution  Explorer. 


Theme  s  no  reason  you 
Couldn’t  build  your 
proyams  in  Notepad, 
but  it’d  be  a  lot 
time— Consuming- 


The  .NET  Framework  gives  you  the  right  tools  for  the  job 

C#  is  just  a  language  by  itself,  it  can't  actually  do  anything.  And  that’s  where 
the  .NET  Framework  comes  in.  Remember  that  Maximize  button  you  turned 
olf  for  the  Contacts  form?  When  you  click  the  Maximize  button  on  a  window, 
there’s  code  that  tells  the  window  how  to  maximize  itself  and  take  up  the  whole 
screen.  That  code  is  part  of  the  .NET  Framework.  Buttons,  checkboxes,  lists... 
those  are  all  pieces  of  the  .NET  framework.  So  are  the  internal  bits  that  hooked 
your  form  up  to  the  database.  It’s  got  tools  to  draw  graphics,  read  and  write  files, 
manage  collections  of  things...  all  sorts  of  tools  for  a  lot  of  jobs  that  programmers 
have  to  do  every  day. 


The  tools  in  the  .NET  Framework  are  divided  up  into  namespaces.  You’ve 
seen  these  namespaces  belore,  at  the  top  of  your  code  in  the  “using”  lines.  One 
namespace  is  called  System. Windows. Forms — it’s  where  your  buttons,  checkboxes, 
and  forms  come  from.  Whenever  you  create  a  new  Windows  Forms  Application 
project,  the  IDE  w  ill  add  the  necessary  files  so  lliat  your  project  contains  a  form, 
and  those  files  have  the  line  “using  System. Windows .  Forms; ”  at  the  top. 
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Puild  the  program  to  create  an  executable 

When  you  select  “Build  Solution”  from  the  Build  menu,  the  IDE 
compiles  your  program.  It  does  this  by  running  the  compiler,  which 
is  a  tool  that  reads  your  program’s  source  code  and  turns  it  into  an 
executable.  The  executable  is  a  file  on  your  disk  that  ends  in  .exe 
that's  what  you  double-click  on  to  run  your  program.  W  hen  you  build 
the  program,  it  creates  the  executable  inside  the  bin  folder,  which 
is  inside  the  project  folder.  When  you  publish  your  solution,  it  copies 
the  executable  (and  any  other  files  necessary)  into  the  folder  you're 
publishing  to. 

When  you  select  “Start  Debugging''  from  the  Debug  menu,  the  IDE 
compiles  your  program  and  runs  the  executable.  It's  got  some  more 
advanced  tools  for  debugging  your  program,  which  just  means  running 
it  and  being  able  to  pause  (or  “break”)  it  so  you  can  figure  out  what’s 
going  on. 


Your  program  runs  Inside  the  Cl£ 

When  you  double-click  on  the  executable,  Windows  runs  your  program. 
But  there's  an  extra  “layer”  between  Windows  and  your  program  called 
the  Common  Language  Runtime,  or  GLR.  Once  upon  a  time,  not 
so  long  ago  (but  before  C#  was  around),  writing  programs  was  harder, 
because  you  had  to  deal  with  hardware  and  low-level  machine  stuff.  You 
never  knew  exactly  how  someone  was  going  to  configure  his  computer. 
The  CLR — often  referred  to  as  a  virtual  machine — takes  care  of  all 
that  for  you  by  doing  a  sort  of  “translation”  between  your  program  and 
the  computer  running  it. 

'tou'll  learn  about  all  sorts  of  things  the  CLR  does  for  you.  For  example, 
it  tightly  manages  your  computer’s  memory  by  figuring  out  when  your 
program  is  finished  with  certain  pieces  of  data  and  getting  rid  of  them 
for  you.  That’s  something  programmers  used  to  have  to  do  themselves, 
and  it’s  something  that  you  don’t  have  to  be  bothered  with.  You  won't 
know  it  at  the  time,  but  the  CI.R  will  make  your  job  of  learning  C#  a 
whole  lot  easier. 


/ffgam 

You  don't  really  have  to  worry 
about  the  CLR  much  "5^ 

now.  It’s  enough  to  know 
it’s  there,  and  takes  tare 
o£  running  your  program  for 
you  automatically  Y°v’"  l**’r*' 
more  about  it  as  you  50 
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mother’s  little  helper 


The  IPE  helps  you  code 

You’ve  already  seen  a  lew  of  the  things  that  the  IDE  ran  do. 
Let’s  take  a  closer  look  at  some  of  the  tools  it  gives  you. 


The  Solution  Explorer  shows  you  everything  in  your  project 

You'll  spend  a  lot  of  time  going  back  and  forth  between  classes,  and  the  easiest 
way  to  do  that  is  to  use  the  solution  explorer.  It's  got  two  views:  a  Solution 
Explorer  view  (which  shows  you  the  files  in  your  project)  and  a  Class  View 
(which  shows  you  how  your  code  logically  breaks  down  into  classes). 


Solution  Explorer  [*] 


Qi 


Solution  ‘Contacts’  (1  project) 


a  3  Contacts 

a  ia  Properties 
a  &  References 
app.config 

a  Q  ContactDB.mdf 
a  &  ContactDBDataSet.  xsd 
a  9  Forml.cs 
<3}  Program.es 


^Solution  Explorer  S^CIass  View  ] 


< — > 

The  Solution 
Explore*-  shows 
you  how  the 
di-PPerent  -Piles 
in  the  solution 
•Polder 


You'll  learn 
more  about, 
classes  in  a 
minute- 


Class  View 


<Search> 


□  . 


Contacts 


a  @  | _ 

a  ci  Project  References 
a  O  Contacts 

a  4$  ContactDBDataSet 
a  ^jForml 
a  &  Program 
a  { >  Contacts.PropertJes 
a  &  Resources 
a  gt  Settings 


^Solution  Explorer  3$ Class  View 


Use  the  tabs  to  switch  between  open  files 

Since  your  program  is  split  up  into  more  than  one  lile,  you'll  usually  have  several 
code  files  open  at  once.  When  you  do,  each  one  will  be  in  its  own  tab  in  the  code 
editor.  The  IDE  displays  an  asterisk  (*)  next  to  a  filename  if  it  hasn't  been  saved  yet. 


Here's  -the  Porm's 
resource  •Pile  that 
you  added  -the 
Objedtville  Paper 
Company  lo<jo  to- 


Form  l.cs  [Design]  Forml.cs 

Program.es 

Form  l.resx 

_ 

When  you're  workin}  on  a  Porm,  you  tan  have  two  -tabs  Por 
rt  at  the  same  time-one  por  the  Porm  designer,  and  one 
{/>  view  the  Porm  s  tode. 
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The  IDE  helps  you  write  code 

Did  you  notice  little  windows  popping  up  as  you  typed  code  into  the  I1)E?  That’s 
a  feature  called  IntelliSense,  and  it’s  really  useful.  One  thing  it  does  is  show  you 
possible  ways  to  complete  your  current  line  of  code.  If  you  type  MessageBox  and 
then  a  period,  it  knows  that  there  are  three  valid  ways  to  complete  that  line: 


MessageBox. 


-♦ 

* 

♦ 


Equals _ 

ReferenceEquals 

Show 


Tke  IDE  knows  that  Message  Bo*  has  three 
methods  called  Equals,  Reference  Equals,  and 
Show  |f  you  type  S,  it  selects  Show.  fVess 
the  tab  or  enter  key  to  select  it  That  can 
be  a  real  timesaver  if  you’re  typing  a  lot  of 
really  long  method  names. 


If  you  select  Show  and  type  (,  the  IDE's  IntelliSense  will  show  you  information 
about  how  you  can  complete  the  line: 

This  means  that  there  . 

are  2.1  different  ways-^v  MessageBox .  Show  ( 
that  you  can  call  the 

MessageBo*‘s  Show 
method  (like  ways  to 


[3_of  21-o  DialogResult  MessageBox. Show  (string  text,  string  caption) 
ItextTlhetext  to  display  in  the  message  box. 


display  different  buttons 
or  iCons). 


The  IDE  also  has  shortcuts  called  snippets  dial  let  you  type  an  abbreviation  to  tell 
it  to  fill  in  the  rest  of  the  code.  Here’s  a  useful  one:  type  inbox  and  press  the  tab  key 
twice,  and  the  IDE  will  till  in  the  MessageBox .  Show  method  for  you: 


MessageBox . Show \ 


’Test ’ 


The  Error  List  helps  you  troubleshoot  compiler  errors 

If  you  haven’t  already  discovered  how  easy  it  is  to  make  typos  in  a  G# 
program,  you'll  find  out  very  soon!  Luckily,  the  IDE  gives  you  a  great  tool  for 
troubleshooting  them.  When  y  ou  build  your  solution,  any  problems  that  keep  it 
from  compiling  will  show  up  in  the  Error  List  window  at  the  bottom  of  the  IDE: 


VVhen  you  use  Start  Debugging 
to  run  your  program  inside 

Die  IDE,  the  first  thing  it 

does  is  build  your  program.  It 
it  Compiles,  then  your  program 
runs.  It  not,  it  wont  run,  and 
will  show  you  errors  m  the 
Error  List- 


Error  List 


Q  2  Errors  \l&  0  Warnings  ki)  0  Messages 


c 

lO  2  Only  assignment,  cal,  increment,  decrement,  and  Form  l.cs 
new  object  expressions  can  be  used  as  a  statement 


Desorption 


expected 


Fie 


Form  l.cs 


Line  Column  Project 


26  48  Contacts 


16 


13 


Contacts 


Double-click  on  an  error,  and  the  IDE  will  jump  to  the  problem  in  the  rode: 


private  void  pictureBoxl_Click (object  sender,  EventArgs  e) 

(  The  IDE  will  show  a  red 

MessageBox .  Show  ( "Contact  List  1.0")^  underscore  where  it  finds 


} 


^you’re  missing  a  semicolon 
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let’s  dig  in 


Whew  you  change  things  in  the  IPE, 
you're  also  changing  your  code 


Me*  you  see  a  “Do  this1",  yoy  oyen  the  IDB 
*d  follow  alon5  We'll  tell  you  e*attly  what 
to  do,  and  point  out  whdt  to  look  for  to  ^et 
the  most  out  of  the  e*amyle  we  show  you  -\ 


The  IDE  is  great  at  writing  visual  code  for  you.  But  don’t 
Like  our  word  for  it.  Open  up  Visual  Studio,  create  a  new 
Windows  Application  project,  and  see  for  yourself. 


Open  up  the  designer  code 

Open  the  Forml .  Designer .  cs  lile  in  the  IDE.  But  this  time,  instead  of  opening  it  in 
the  Form  Designer,  open  up  its  rode  by  right-clicking  on  it  in  the  Solution  Explorer  and 
selecting  “View  Code”.  Look  for  the  Forml  class  declaration: 

how  it's  a  partial  class? 


public  partial  class  Forml  :  Form 


Open  up  the  Form  designer  and  add  a  PictureBox  to  your  form 

Get  used  to  working  with  more  than  one  tab.  Go  to  the  Solution  Explorer  and  open  up  the 
Form  designer  by  double-clicking  on  Forml .  cs.  Drag  a  new  PictureBox  onto  a  new  form. 


Find  and  expand  the  designer-generated  code  for  the  PictureBox  control 

Then  go  back  to  the  Forml .  Designer  .  cs  tab  in  the  IDE.  Scroll  down  and  look  for  this  line  in 
the  code: 

^  Click  the  plus  siy> 

0  Windows  Form  Designer  generated  code 


Click  on  the  +  on  the  left-hand  side  of  the  line  to  expand  the  code.  Scroll  down  and  find  these  lines: 


// 

//  pictureBoxl 

// 


this .pictureBoxl . Location  =  new  System. Drawing. Point (276, 


this .pictureBoxl .Name  =  "pictureBoxl"; 


Doft't  worry  if  the 
numbers  in  your  Code 
for  the  Location  and 
Size  lines  are  a  little 
different  than  these  ■ 


this. pictureBoxl. Size  =  new  System. Drawing. Size (100,  50); 


this .pictureBoxl . Tablndex  =  1; 


this. pictureBoxl. TabStop  =  false; 
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it’s  all  just  code 


Wait,  wait!  What  did  that  say? 


Scroll  back  up  lor  a  minute.  There  it  is.  at  the  top  of  the  Windows 
Form  Designer  generated  code  section. 

Ill  <summary> 

III  Required  method  for  Designer  support  -  do  not  modify 
III  the  contents  of  this  method  with  the  code  editor. 

Ill  </summary> 


Most  dommenti  only  start 
with  two  slashes  (//) 

But  the  IDE  sometimes 
adds  these  three-slash 
domments 


There’s  nothing  more  attractive  to  a  kid  than  a  big  sign  that  says,  “Don’t 
touch  litis!"  Come  on,  you  know  you’re  templed...  let’s  go  modify  the 
contents  of  that  method  with  the  code  editor!  Add  a  button  to  your 
form,  and  then  go  ahead  and  do  this: 


Change  the  code  that  sets  the  button  1. Text  property.  What 
do  you  think  it  will  do  to  the  Properties  window  in  the  IDE? 

Give  it  a  shot — see  what  happens!  Now  go  back  to  the  form  designer  and 
check  the  Text  property.  Did  it  change? 


O 

o 

o 


Stay  in  the  designer,  and  use  the  Properties  window  to 
change  the  Name  property  to  something  else. 

See  if  you  can  find  a  way  to  get  the  IDE  to  change  the  Name  property.  It’s 
in  the  Properties  window  at  the  very  lop.  under  “(Name)’’.  What  happened 
to  the  code?  What  about  the  comment  in  the  code? 


Change  the  code  that  sets  the  Location  property  to  (0,0)  and 
the  Size  property  to  make  the  button  really  big. 

Did  it  work? 


Go  back  to  the  designer,  and  change  the  button's  BackColor 
property  to  something  else. 

Look  closely  at  the  Fbrml.Designer.es  code.  Were  any  lines  added? 


You  don't  have  to 
Urn  or  run  Die 
to  see  the  thanes-  Just 
make  the  change  ■*»  the 

tode  editor ,  and  then  tl.dk 
on  the  designer  tab  to  Fl.y 
over  to  the  for.  desi^ner- 
the  thanks  should  show  u? 
immediately 


It’s  always  easier  to  use  the  IDE  to  change  your  form’s 
Designer-generated  code.  But  when  you  do,  any  change  you 
make  in  the  IDE  ends  up  as  a  change  to  your  projects’  code. 


you  are  here  ► 
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your  program  makes  a  statement 


Anatomy  of  a  program 

Every  C#  program's  rode  is  structured  in  exactly  the 
same  way.  All  programs  use  namespaces,  classes, 
and  methods  to  make  your  code  easier  to  manage. 

A  class  contains  a  pi tu  of  your 
froyam  (although  so«e  very  s-all 
yroyra ms  can  Wave  >st  one  classX 


A  class  Was  one  or  more  methods 
Your  methods  always  Wave  to 
'vc  ins.de  a  class  And  methods 

are  made  up  of  statements— like _ 

the  ones  you’ve  already  seen 


“c+ine  a  namespace  -Poe  i-t  r.?77  T* 

*NMh  ^  -MET 


Namespace 


/ 


Class 


Method  1 
statement 
statement 


Method  2 
statement 
statement 


let's  take  a  closer  look  at  your  code 

Open  up  the  code  from  your  Contact  project’s  Forml .  cs  so 
we  can  go  through  it  piece  by  piece. 


The  code  file  starts  by  using  the  .NET  Framework  tools 

You'll  find  a  set  of  using  lines  at  the  top  of  every  program  file.  They  tell  C#  which  parts  of 
the  .NET  Framework  to  use.  If  you  use  oilier  classes  that  are  in  oilier  namespaces,  then  you'll 
add  using  lines  for  them  too.  Since  forms  often  use  a  lot  of  different  tools  from  the  .NE  E 
Framework,  the  IDE  automatically  adds  a  bunch  of  using  lines  when  it  creates  a  form  and 
adds  it  to  your  project. 


using 

using 

using 

using 

using 

using 

using 

using 


System;  ^ 

System .  Collections  .  Generic ;  /  These  using  lines  are  at  the 


System . ComponentModel ; 
System . Data ; 

System . Drawing ; 

System . Linq; 

System. Text; 

System . Windows . Forms ; 


top  of  every  Code  file.  They  tell 
C#  to  use  all  of  those  NET 
Framework  classes  Each  one  tells 
your  program  that  the  classes  in 
this  particular  .cs  file  will  use  all 
of  the  Classes  in  one  specific  NET 
Framework  namespace 
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kT 

namespace  Contacts 


Look  for  the 
matching  pairs 
of  brackets 
Every  {  is 
eventually 
faired  up  with 
a  }  Some 
pairs  can  be 
inside  others 


C#  programs  are  organized  into  classes 

Every  C#  program  is  organized  into  classes.  A  class  can  do  anything,  but  most  classes  do  one 
specific  tiling.  When  you  created  the  new  program,  the  IDE  added  a  class  called  Forml  that 

displays  a  form.  - _  When  you  called  your  program  Contacts,  the  IDE  Created  a 

namespace  for  it  called  Contacts  by  adding  the  namespace 
keyword  at  the  top  of  your  Code  -file  Everything  inside  its 
pair  o-f  Curly  brackets  is  part  of  the  Contacts  namespace 

public  partial  class  Forml  :  Form 

/b  This  is  a  class  called  Eorml.  It  contains  all  of  the  Code  to  draw  the 
'  form  and  the  Toolbox  Controls  on  it-  The  IDE  Created  it  when  you 

told  it  to  create  a  new  Windows  Forms  Application  project 

Classes  contain  methods  that  perform  actions 

When  a  class  needs  to  do  something,  it  uses  a  method.  A  method  takes  an  input,  performs 
some  action,  and  sometimes  produces  an  output.  The  way  you  pass  input  into  a  method  is  by 
using  parameters.  Methods  can  behave  differently  depending  on  what  input  they’re  given. 

Some  methods  produce  output.  When  they  do.  it's  called  a  return  value.  If  you  see  the 
keyword  void  in  front  of  a  method,  that  means  it  doesn't  return  anything 


public  Forml  () 

{ 


} 


This  lire  Calls  a  method  named 
nitialiieComponentO,  which  the 
IDE  also  Created  for  you 


Ini tiali zeComponent 


A  statement  performs  one  single  action 

When  you  added  the  Message  Box.  ShowO  line  to  your  program,  you  were  adding  a  statement. 

Every  method  is  made  up  of  statements.  When  your  program  calls  a  method,  it  executes  the 
first  statement  in  the  method,  then  the  next,  then  the  next,  etc.  When  the  method  runs  out  of 
statements  or  hits  a  return  statement,  it  ends,  and  the  program  resumes  alter  the  statement 
that  originally  called  the  method. 

_  ,4-kod  called  pictureBoxI  ChtkO  that  This  method  has  two  parameters  called 

This  is  a  method  tailed  r  -r-  nizture  box  \  sender  and  e  \ 

called  tkc  »  tke  f14”"  V  /  \ 

private  void  pictureBoxl  Click (object  sender,  EventArgs  e) 


{ 


MessageBox . Show ("Contact  List  1.0",  "About"); 

^  y<>u r  statement  called  the  ShowO  method, 

This  is  a  statement  you  already  which  is  part  of  the  MessageBox  class,  which 

know  what  it  does— it  pops  up  a  is  inside  the  System  Windows  Forms  namespace 

little  message  box  window  A 

'{ovr  statement  passed  two  parameters  to  the  ShowO  y 
method  The  f  irst  one  was  a  string  of  text  to  display 
m  the  message  box,  and  the  second  one  was  a  string  to 
display  in  its  title  bar  you  are  here  , 
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a  closer  look 


Your  program  knows  where  to  start 

When  you  created  the  new  Windows  Application  solution,  one  of  the  files  the 
IDE  added  was  called  Program.es.  Go  to  the  Solution  Explorer  and  double¬ 
click  on  it.  It's  got  a  class  called  Program,  and  inside  that  class  is  a  method  called 
MainQ.  That  method  is  the  entry  point,  which  means  that  it's  the  very  fu  st  tiling 
that’s  run  in  your  program. 

Here's  some  Code  the  IDE  built  for  you 
automatically  in  the  last  chapter  Vou'11  J 
•find  it  in  Proftram.Cs  l  / 

O - - - 

using  System; 

using  System. Linq; 

using  System . Collections . Generic ; 

using  System. Windows . Forms ; 

G  ^  The  narrate  W  all  this  code  * 

namespace  Contacts  Contatts  Wfe"  ^ 

{  more  in  a  f c»  pays. 


Every  C#  program  can  only 
have  one  entry  point  method, 
and  its  called  /VJainO. 
Thats  how  it  knows  where  to 
start  when  you  run  it. 

a 

/dui-  CdJe  tip  Cjosc 


C 


static  class  Program  __  Lines  that  begin  with  slashes  are  comments,  which 

/  Y°u  add  anywhere  you  want-  The  slashes  tell 
1/  C#to  ignore  them 

III  <summary>  YX 

III  The  main  entry  point  for  the  application. 

Ill  </summary>  p 

_ _ _  7*7  yov  run  your  program, 

[ STAThread]  ^  .t  starts  here,  at  the  entry>o,nt. 

static  void 


[STAThread] 


Application . EnableVisualStyles () ; 

^Application. SetCompatibleTextRenderingDef ault (false) ; 
Application .  Run  (new  Forml  ( )  )  - ™is  <>eates  and 


I  do  declare/ 

The  -first  line  o-f  every  class  or 
method  is  called  the  declarator 


-This  statement  Creates  and 
displays  the  Contacts  form,  and 
ends  the  program  when  the 
form's  closed 


/[\  Remember,  this  is  just  a  starting  point  -for  you  to 

V - dig  into  the  Code  But  before  you  do,  you'll  need  to 

know  what  you're  looking  at 
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C#  and  .NET  have  lots  of  built-in  features. 

You’ll  find  lines  like  this  at  the  top  of  almost  even,'  C#  class 

file.  System.  Windows .  Forms  is  a  namespace.  The  programs  will  use  wore  and  "ore 

using  System. Windows  .Forms  line  makes  everything  - -  names^ates  like -this  one  as  you  learn 

in  that  namespace  available  to  your  program.  In  this  case,  that  abou-t  C#  and  NBT’s  other  built-in 

namespace  has  lots  of  visual  elements  in  it  like  buttons  and  -features  throughout  the  book 

forms. 


The  IDE  chose  a  namespace  for  your  code. 

Here’s  the  namespace  the  IDE  created  for  you  it  chose 
Contacts  based  on  your  project’s  name.  All  of  the  code  in 
your  program  lives  in  this  namespace. 

Your  code  is  stored  in  a  class. 

This  particular  class  is  called  Program.  The  IDE  created  it 
and  added  the  code  that  starts  the  program  and  brings  up  the 
Contacts  form. 


Na^soaces  let  you  use  the  same  name 
,h  d'44e're»'t  programs,  as  long  as  those 
programs  aren't  also  in  the  same  namespace- 

^2,  tan  have  multiple 
tlasses  in  a  "a"'es?a 


O  This  code  has  one  method,  and  it 
contains  three  statements. 

A  namespace  luts  classes  in  it,  and  classes  have  methods. 
Inside  each  method  is  a  set  of  statements.  In  this 
program,  the  statements  handle  starting  up  the  Contacts 
form.  Methods  are  where  the  action  happens  every 
method  does  something. 

O  Each  program  has  a  special  kind  of 
method  called  the  entry  point. 

Every  C#  program  must  have  exactly  one 
method  called  Main.  Even  though  your 
program  has  a  lot  of  methods,  only  one  can  be 
the  first  one  that  gets  executed,  and  that’s  your 
Main  method.  C#  checks  every  class  in  your 
code  for  a  method  that  reads  static  void 
Main  ( ) .  1’hen,  when  the  program  is  riut,  the 
first  statement  in  this  method  gets  executed,  and 
everything  else  follows  from  that  first  statement. 


Every  O  program  must 
have  exactly  one  method 
called  Main.  That  method 
is  the  entry  point  lor 
your  code. 

When  you  run  your  code, 
the  code  in  your  MainO 
method  is  executed  FIRST. 


you  are  here  * 


55 


classy  things 


You  can  change  your 
program's  entry  point 

As  long  as  your  program  has  an  entry  point,  it  doesn’t 
matter  which  elass  your  entry  point  method  is  in,  or 
what  that  method  does.  Let’s  remove  the  Main  method 
in  Program.es,  and  create  a  new  entry  point. 


r 


D*  this' 


Do  hack  to  Program .  cs  and  change  the  name  of  the  Main  method  to 
NotMain.  Now  try  to  build  and  run  the  program.  What  happens? 


Vtfnte  down  what  hayye^d 

when  you  thawed  the 

method  name,  and  why  y<* 

thmk  that  hayyened 
1 


Ri^ht-click  on  the 


Now  let’s  create  a  new  entry  point.  Add  a  new  class  called  AnotherClass .  select  "Add^a^d 


cs.  You  add  a  class  to  your  program  by  right-clicking  on  the  project  name 
in  the  Solution  Explorer  and  selecting  “Add>>Class...”.  Name  your  class  —  . 

lile  AnotherClass  .  cs.  The  IDE  will  add  a  class  to  your  program  called 
AnotherClass.  Here’s  the  file  the  IDE  added: 


"Class.." 


using  System; 

using  System. Linq; 

using  System. Collections .Generic; 

using  System. Text; 

namespace  Contacts 
1 

class  AnotherClass 


{ 


) 


O  Add  a  new  using  line  to  the  top  of  the  file:  using  System.  Windows  .  Forms  ; 
Don’t  forget  to  end  the  line  with  a  semicolon! 


These  four  standard  using 
lines  were  added  to  the  file 

This  elass  is  in  the  same  Contacts  namesyace 
that  the  IDE  added  when  you  first  Created 
the  Windows  Affliction  froject 


n<  m  thc 

£|J”  «  tt.  filLme. 


Add  this  method  to  the  AnotherClass  class  by  typing  it  in  between  the  curly  brackets: 


MessayBo*  is  a  class  that  lives 

in  the  SystemiYindows  Forms 
namesyace,  which  is  why  you  had 
to  add  the  usin<J  line  in  srtef  &?>  ~~~ 
ShowO  is  a  method  that's  fart  of 
the  Messa$eBo*  class 


class  AnotherClass 

{ 

public  static  void  Main() 

{ 

MessageBox . Show ( "Pow \") ; 

} 
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So  what  happened? 

Instead  of  popping  up  the  Contacts  application,  your 
program  now  shows  this  messagebox.  When  you  made 
the  new  MainQ  method,  you  gave  your  program  a  new 
entry  point.  Now  the  first  thing  the  program  does  is  run 
the  statements  in  that  method — which  means  running  that 
Message  Box. Show()  statement.  There’s  nothing  else  in  that 
method,  so  once  you  click  the  OK  button,  the  program 
runs  out  of  statements  to  execute  and  then  it  ends. 


f  igure  out  how  to  fix  your  program  so  it  pops  up  Contacts  again. 


Hmt  only  have 
■to  thany  two  lines  in 
two  -f  iles  to  do  it. 


Fill  in  the  annotations  so  they  describe  the  lines  in  this  C#  file 
that  they're  pointing  to.  We’ve  filled  in  the  first  one  for  you. 


Q#  diasses  Haye  thesi 

lines  add  "'.ctHods 

other  namesyates . 


using  System;  ~ 

using  System. Linq;  t 

using  System. Text; 
using  System . Windows . Forms 


public  static  void  DoSome thing ( )  { 


you  are  here  ► 
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get  some  answers 


there  j  ore  n<? 

Dumb  Questions 


%  What’s  with  all  the  curly  brackets? 

j\'  C#  uses  curly  brackets  (or  ‘braces")  to 
group  statements  together  into  blocks.  Curly 
brackets  always  come  in  pairs  You'll  only 
see  a  closing  curly  bracket  after  you  see  an 
opening  one.  The  IDE  helps  you  match  up 
curly  brackets— just  click  on  one,  and  you'll 
see  it  and  its  match  get  shaded  darker 

o 

|  don't  quite  get  what  the  entry 
point  is.  Can  you  explain  it  one  more 
time? 


Your  program  has  a  whole  lot  of 
statements  in  it,  but  they're  not  all  run  at 
once.  The  program  starts  with  the  first 
statement  in  the  program,  executes  it,  and 
then  goes  on  to  the  next  one,  and  the  next 
one,  etc.  Those  statements  are  usually 
organized  into  a  bunch  of  classes  So  when 
you  run  your  program,  how  does  it  know 
which  statement  to  start  with? 

That's  where  the  entry  point  comes  in.  The 
compiler  will  not  build  your  code  unless  there 
is  exactly  one  method  called  Main()  which 
we  call  the  entry  point.  The  program  starts 
running  with  the  first  statement  in  Main(). 


(V 

vv^.  How  come  I  get  errors  in  the 
Error  List  window  when  I  try  to  run  my 
program?  I  thought  that  only  happened 
when  I  did  "Build  Solution.” 

Because  the  first  thing  that  happens 
when  you  choose  “Start  Debugging"  from 
the  menu  or  press  the  toolbar  button  to 
start  your  program  running  is  that  it  saves 
all  the  files  in  your  solution  and  then  tries  to 
compile  them.  And  when  you  compile  your 
code — whether  it's  when  you  run  it,  or  when 
you  build  the  solution— if  there  are  errors, 
the  IDE  will  display  them  in  the  Error  List 
instead  of  running  your  program. 


using 

using 

using 

using 


System; 

System. Linq; 

System. Text; 

System . Windows . Forms 


Fill  in  the  annotations  so  they  describe  the  lines  in  this  C#  file 
that  they're  pointing  to.  We've  filled  in  the  first  one  for  you. 

C*  tU«s  W 

fa,  add  *"» 

other  narrates 


namespace  SomeNaroespace 
< 

class  MyClass  { 


All  of  'the  Code  lives  in 
classes,  so  the  program 
needs  a  class  here 


This  is  a  method  Every 
method  in  the  program 
does  something  Methods 
are  used  to  group 
statements  together 


> 


public  static  void  DoSome thing ( )  { 

Me s sage Box. Show ("This  is  a  message") ; 

} 


This  is  a  statement 
When  it’s  executed. 

it  ?o?s  u?  a  £ 

1  .  •  LL 
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* 


Match  each  of  these  fragments  of  code  generated  by  the  IDE  to  what  it  does. 
(Some  of  these  are  new  take  a  guess  and  see  if  you  got  it  right!) 


Set  properties  for  a  label 


_  Nothing — it’s  a  comment  that  die 

programmer  added  to  explain  the  code 
to  anyone  who’s  reading  it 


Disable  the  maximize  icon  (Q  )  in  die 
title  bar  of  die  Form  1  window 


A  special  kind  of  comment  that  the  IDE 
uses  to  explain  what  an  entire  block  of 
code  does 


number_of_pit_stopsLabel .Name 

=  "number_of_pit_stopsLabel"; 
number_of_pit_stopsLabel .Size 

=  new  System. Drawing. Size (135,  17); 
number_of_pit_stopsLabel .Text 

=  "Number  of  pit  stops:"; 


partial  class  Forml 
{ 

private  void  InitializeComponent ( ) 
{ 

i 

) 


partial  class  Forml 

< 

this .BackColor  =  Color .DarkViolet; 


III  <summary> 

III  Bring  up  the  picture  of  Rover  when 
III  the  button  is  clicked 
III  </summary> 


Change  the  background  color  of  the 
Form  I  window 


partial  class  Forml 
t 

this.MaximizeBox  =  false; 


A  block  of  code  that  executes  whenever 
a  program  opens  up  a  Form  1  window 


you  are  here  ► 
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exercise  solution 


Match  each  of  these  fragments  of  code  generated  by  the  IDE  to  what  it  does. 
(Some  of  these  are  new — take  a  guess  and  see  if  you  got  it  right!) 


partial  class  Forml 
{ 


this.BackColor  =  Color. Darkviolet; 


II  This  loop  gets  executed  three  times 


I  partial  class  Forml 

I 

private  void  initializecomponent ( ) 
( 

i 


L 


number_o£_pit_stopsLabel .Name 

=  "number_of_pit_stopsLabel"; 
number_of_pit_stopsLabel . size 

=  new  System. Drawing. Size (135,  17), 
number_of_pit_stopsLabel .Text 

=  "Number  of  pit  stops:"; 


III  <summary> 

III  Bring  up  the  picture  of  Rover  when 
III  the  button  is  clicked 
III  </summary> 


partial  class  Forml 
( 


this.MaximizeBox  =  false; 


Set  properties  for  a  label 


Nothing — it’s  a  comment  that  the 
programmer  added  to  explain  the  code 
to  anyone  who’s  reading  it 


Disable  the  maximize  icon  (Q)  in  the 
title  bar  of  the  Form  1  window 


A  special  kind  of  comment  that  the  IDE 
uses  to  explain  what  an  entire  block  of 
code  does 


Change  the  background  color  of  the 
Form  1  window 


A  block  of  code  that  executes  whenever 
a  program  opens  up  a  Form  1  window 
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Two  classes  can  be  in  the 


namespace  PetFiler2  { 


public  class  Fish  { 


public  void  Swim()  { 
//  statements 


public  partial  class  Cat  { 


public  void  Purr()  { 
//  statements 

} 


\  Sinde  these  classes  are  in  the  same 
namespace,  they  tan  all  "see"  each 
other— even  though  theyVe  in 
different  -files.  A  class  can  span 
multiple  -Piles  too,  but  you  need  to 
use  the  "partial"  keyword  when  you 
declare  it-  a 

1 

You  can  only  split  a  class  up  into  different 
files  if  you  use  the  partial  keyword 
You  probably  won't  do  that  in  any  of  the 
Code  you  write  in  this  book,  but  the  IDE 
used  it  fo  split  your  form  up  into  two  files, 
Forml  cs  and  Forml  Designer  Cs. 


same  namespace 


SomeCiasses.es 


namespace  PetFiler2  { 


^  public  class  Dog  { 


public  void  Bark()  { 

//  statements  go  here, 

} 


public  void  Meow()  { 
//  more  statements 

’  A 

- -  _ 


Take  a  look  at  these  two  class  files  from  a 
program  called  l'etFiler'2.  TheyVe  got  three 
classes:  a  Dog  class,  a  Cat  class,  and  a  Fish 
class.  Since  they’re  all  in  the  same  FetFiler2 
namespace,  statements  in  the  Dog.BarkQ 
method  can  call  Cat.MeowO  and  Fish.Swim(). 
It  doesn’t  matter  how  the  various  namespaces 
and  classes  are  divided  up  between  files.  They 
still  act  the  same  when  they’re  rtui. 


When  a  tla«  is 

if  means  every  °^ec 
tlass  m  the  program 
access  its  methods 


MoreClasses.es 
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your  mileage  may  vary 


Your  programs  use  variables  to  work  with  data 

W  hen  you  get  right  down  to  it,  every  program  is  basically  a  data  cruncher. 
Sometimes  the  data  is  in  the  form  of  a  document,  or  an  image  in  a 
video  game,  or  an  instant  message.  But  it’s  all  just  data.  And  that’s  where 
variables  come  in.  A  variable  is  what  your  program  uses  to  store  data. 


declare  your  variables 

Whenever  you  declare  a  variable,  you  tell  your  program  its  type  and  its  name. 
Once  C#  knows  yotu'  variable's  type,  it'll  keep  your  program  from  compiling 
if  you  make  a  mistake  and  try  to  do  something  that  doesn’t  make  sense,  like 
subtract  “Fido”  from  48353. 


Variables  vary 

A  variable  is  equal  to  different  values  at  different  times  while  your 
program  runs.  In  other  words,  a  variable’s  value  varies.  (Which  is 
why  “variable”  is  such  a  good  name.)  This  is  really  important,  because 
that  idea  is  at  the  core  of  every  program  that  you’ve  written  or  will  ever 
write.  So  if  your  program  sets  the  variable  myHeight  equal  to  63: 

int  myHeight  =  63; 

any  time  myHeight  appears  in  the  code,  C#  will  replace  it  with  its 
value,  63.  Then,  later  on,  if  you  change  its  value  to  12: 

myHeight  =  12? 

C#  will  replace  myHeight  with  12 — but  the  variable  is  still  called 
myHeight. 


Whenever  jour 
program  needs  to 
work  witli  numbers, 
text,  true/ false 
values,  or  anj  other 
kind  of  data,  jou’ll 
use  variables  to  keep 
track  of  them. 


62  Chapter  2 


it’s  all  just  code 


You  have  to  assign  values  to  variables  before 
you  use  them 


Try  putting  these  statements  into  a  C#  program: 


int  z  ; 

MessageBox. Show ("The  answer  is  "  +  z); 


Go  ahead,  give  it  a  shot.  You’ll  get  an  error,  and  the  IDE 
will  refuse  to  compile  your  code.  That’s  because  the  IDE 
checks  each  variable  to  make  sure  that  you’ve  assigned  it  a 
value  before  you  use  it.  The  easiest  way  to  make  sure  you 
don't  forget  to  assign  your  variables  values  is  to  combine 
the  statement  that  declares  a  variable  with  a  statement  that 
assigns  its  value: 


xWeight  =(  25000; 
message \= 

oxChecked 


These  values 
are  assigned  to 
•the  variables 


Each  declaration  has  a  type, 
exactly  like  before. 


A  few  useful  types 

Every  variable  has  a  ty  pe  that  tells  CM  what  kind  of  data  it  can 
hold.  We’ll  go  into  a  lot  of  detail  about  the  many  different  types 
in  CM  in  Chapter  4.  In  the  meantime,  we’ll  concentrate  on  the 
three  most  popular  types,  int  holds  integers  (or  whole  numbers), 
string  holds  text,  and  bool  holds  Boolean  true/false  values. 


var-i-a-ble,  adjective. 

able  to  be  changed  or  adapted 
the  drill's  variable  speed  hit  let 
Boh  change  the  drill  speed  from  slow 
to  fast  based  on  the  job  he  had  to  do. 


If  you  write  code 
tli  at  uses  a  variable 
tliat  hasn't  heen 
assigned  a  value, 
your  code  won’t 
compile.  It’s  easy 
to  avoid  that  error 
hy  combining  your 
variable  declaration 
and  assignment  into  a 
single  statement. 


} 

f*4*  *"•'*  Jssi9^  a  v^ 

to  your  variable,  that  vj)ue 
So  there's  *0 

disadvantage  to  assign, a 

variable  an  initial  value  when 

you  declare  it 


you  are  here  * 
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operators  are  standing  by 


C#  uses  familiar  math  symbols 


( )nce  you’ve  got  some  data  stored  in  a  variable,  what  can  you 
do  with  it?  Well,  if  it’s  a  number,  you'll  probably  want  to  add, 
subtract,  multiply,  or  divide  it.  And  that’s  where  operators  come 
in.  You  already  know  die  basic  ones.  Let’s  talk  about  a  few  more. 
Here's  a  block  of  code  that  uses  operators  to  do  some  simple  math: 


VVe  declared  a  new 
int  variable  tailed 
number  and  set  it 
to  1 5-  Then  we  added 
10  to  it  After  the 
second  statement, 
number  is  egual  to  Z5. 


int  number  =  15; 

> 

number  =  number  +  10; 

number  =  36  *  15;^^ - 

number  =  12  -  (42  /  7) 

number  +=  10;  - 

>number  *=  3 ; 


^.number  *=  3; 

“  /  number  =  71/3; 

it  multiplies  A 

the  Current  value  of- 

number  by  1,  so  it  ' 

ends  up  set  to  4-0  int  count  =  0  ; 


Tbe  third  statement  changes  the 
value  of  number,  setting  it  egual 
■  to  Si  times  15,  which  is  54"0  Then 
it  vesets  it  again,  setting  it  egual 
to  IZ  -  (4-2-  /  7),  which  is  h. 


This  operator  is  a  little  different  +- 
means  take  the  value  of  number 
and  add  10  to  i-t  Since  number  is 
Currently  egual  to  h,  adding  10  to  it 
sets  its  value  to  It 


_ _  71  divided  by  l  is  ZIUUkk 


/  r "  ,  *  ,s  ^1°OOCe6  number  is  an  integer, 

•t  can  only  store  whole  numbers,  so  it  gets  rounded  to  2.3 


This  MessageBo* 
will  pop  up  a  bo* 
that  says  "hello 
again  hello” 


count  ++; 
count  — ; 


You’ll  use  int  a  lot  for  Countng,  and  when  you  do  the  ++ 

_ operators  Come  in  handy  -ft  increments  count 

by  adding  one  to  the  value,  and  —  decrements  count 
by  subtracting  one  from  it,  so  it  ends  up  egual  to  zero 


string  result  =  "hello" ; 
result  +=  "  again  "  +  result; 


result  +=  "  again  "  +  result;  <£ - When  you  use  the  +  operator 

with  a  string,  it  just  puts 

MessageBox  .  Show  (result)  ;  two  strings  together  It’ll 

The  “’  is  an  empty  string  automatically  convert 

It  has  no  characters  result  =  "the  value  is:  "  +  count;  numbers  to  strings  for  you 

for  adding  strings.)  result 


)  result  = 


A  bool  stores  true 
or  false  live  f 
operator  means  NOT 
It  flips  true  to 
false,  and  vice  versa 
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bool  yesNo  =  false; 
bool  anotherBool  =  true ; 
yesNo  =  ! anotherBool ; 


T^elax 


Don’t  worry  about 
memorizing  these 
operators  now. 


You'll  get  to  know-  them 
because  you’ll  see  ’em  over  and  over  again. 


it's  all  just  code 


Loops  perform  aw  action  over  and  over  again 


Here’s  a  peculiar  thing  about  most  large  programs:  they  almost  always 
involve  doing  certain  things  over  and  over  again.  And  that’s  what 
loops  are  for-  they  tell  your  program  to  keep  executing  a  certain  set 
of  statements  as  long  as  some  condition  is  (True  (or  false!). 


That'*  a  ?*rl 

boolean*  are  SO  important  f I 
loo?  uses  a  -best  -to  b^ure 
oub  if  it  should  keep  looping- 


while  (x  >  5) 

f 

{ 


x  =  x  -  3; 


} 


In  a  while  loop,  all  of 
the  statements  inside 
the  Curly  brackets  get 
executed  as  long  as 
the  Condition  in  the 
parentheses  is  true 


Every  for  loop  has  three  statement^  The  first  sets 
up  the  loop  The  statement  will  keep  looping  as  long  as 
the  second  one  is  true  And  the  third  statement  gets 
executed  after  each  time  through  the  loop 

for  (i  =  0;  i  <  8;  i  =  i  +  2) 


MessageBox . Show ("I ' 11  pop  up  4  times"); 


} 


Use  a  code  snippet  to  write  simple  for  loops 

You’ll  be  typing  for  loops  in  a  just  a  minute,  and  the  IDE  can 
help  speed  up  your  coding  a  little.  Type  for  followed  by  two 
tabs,  and  the  IDE  will  automatically  insert  code  for  you.  If  you 
type  a  new  variable,  it’ll  automatically  update  the  rest  of  the 
snippet.  Press  tab  again,  and  the  cursor  will  jump  to  the  length. 


for  (int  Q  =  0; 


|f  you  Change  the  variable  to 
something  else,  the  snippet 
automatically  changes  the 
other  two  occurrences  of  it- 


Press  tab  to  get  the  Cursor 
to  jump  to  the  length.  The 
number  of  times  this  loop  runs 
is  determined  by  whatever 
)tou  set  length  to-  /ou  can 
Change  length  to  a  number  or  a 
variable. 


fi]  < 


length 
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ready,  set,  code! 


Time  to  start  coding 

The  real  work  of  any  program  is  in  its  statements.  Hut 
statements  don’t  exist  in  a  vacuum.  So  let’s  set  the  stage 
for  digging  in  and  getting  some  code  written.  Create  a 
new  Windows  Forms  Application  project. 

TKis  Wl11  tell  ike  IDE  to  create  a  new  project 
witk  a  blank  -form  and  an  entry  point-  You 
might  want  to  name  it  something  like  "Chapter 
1  program  I'— you'll  be  building  a  whole  lot  of 
T  -*!*-  programs  throughout  the  book 

Built!  [his  Pol'til 

* 


% 


Add  statements  to  show  a  message 

(Jet  started  by  double-clicking  on  the  first  button.  Then  add 
these  6  statements  to  the  buttonl_Click  ( )  method. 
Look  closely  at  the  code,  and  the  output  it  produces. 


- Syntax  101 - 

*  Each  statement  must  end  in  a  semicolon. 

x  =  x  +  1 ; 

*  A  single-line  comment  begins  with  two 
forward  slashes. 

//  this  line  is  ignored 

*  Most  white  space  doesn't  matter. 

x  =  3  ; 

is  the  same  as 

x  =  3  ; 

»  Variables  are  declared  with  a  name  and  a 
type  (there  are  plenty  of  types  that  you'll 
learn  about  in  chapter  4). 

int  weight; 

//  weight  is  an  integer 

Classes  and  methods  must  be  defined 
within  a  pair  of  curly  braces. 

public  void  go()  { 

//  amazing  code  here 

} 


x  ,s  a  variable  The  jjt 

oar-t  tells  C#  that  it  s 
an  integer,  and  the  rest 
the  statement  sets 
its  value  to  T ■  I 


private  void  buttonl_Click (object  sender,  EventArgs  e) 
{ 


//  this  is  a  comment 
String  name  =  "Quentin 
int  0=  3; 


x  =  x 


17; 


double  d  =  Math. PI  /  2; 
MessageBox. Show ("name  is 
+  "\nx  is  "  +  x 
+  "\nd  is  "  +  d); 


There's  a  built-in  class  called 

ulUd  PI.  /Hath  lives  »  the 
rf  ,  namespace,  so  the 
+  'le  this  Code  Came  from 


+  name 


^  The  \n  is  an  escape  seguenCe 
to  add  a  line  break  to  the 
message  box 
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it’s  all  just  coda 


if/ else  statements  make  decisions 


Use  if/ else  statements  to  tell  your  program  to  do  certain 
things  only  when  the  conditions  you  set  up  are  (or  aren’t) 
true.  A  lot  of  if/else  statements  check  if  two  things  are  equal. 
That’s  when  you  use  the  ==  operator.  That's  different  from  the 
single  equal  sign  (=)  operator,  which  you  use  to  set  a  value. 


if 


(someValue  ==  24) 


Utrj  staWe»t 
starts  '"th  A 

tond'tional  test 


{ 


MessageBox . Show ("The  value  was  24."); 

if  ( someValue (==^)2 4 ) 


The  statement  >ns'de 
the  turf/  brackets  is 

- -  executed  onfy  A  the 

test i*  true 


i{/else  statements  are 
pretty  stra.«|htWuiard 
|{  the  Conditional 
test  >s  true,  the 
program  executes  the 
statements  between  the 
first  set  o$  brackets 
Otherwise,  it  executes 
the  statements  between 
the  setond  set 


{ 


// 

// 


You  can  have  as  many  statements 
as  you  want  inside 


the  brackets 

MessageBox . Show ("The  value 
else  { 


was  24.") 


MessageBox . Show ("The  value 


wasn' t  24 . ") 


Watch  it! 


Don’t  confuse  the  two  equal  sign  operators! 

You  use  one  equal  sign  (=)  to  set  a  variable’s  value,  but  two  equal  signs 
(==)  to  compare  two  variables.  You  won't  believe  how  many  bugs  in 
programs — even  ones  made  by  experienced  programmers! — were 
caused  by  using  =  instead  of  ==.  If  you  see  the  IDE  complain  that  you 


“ cannot  implicitly  convert  type  ‘int’  to  boor”,  that's  probably  what  happened. 


you  are  here  ► 
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the  things  you  can  do 


Set  up  conditions  and  see  if  they're  true 


Use  if/ else  statements  to  tell  your  program  to  do  certain 
things  only  when  the  conditions  you  set  up  are  (or  aren’t)  true. 

Use  logical  operators  to  check  conditions 

You’ve  just  looked  at  the  ==  operator,  which  you  use  to  test  whether  tw  o 
variables  are  equal.  There  are  a  few  other  operators,  too.  Don’t  worry  about 
memorizing  them  right  now — you’ll  get  to  know  them  over  the  next  few 
chapters: 

*  The  !  =  operator  works  a  lot  like  =  except  it’s  true  if  the  two  things 
you’re  comparing  are  not  equal. 

*  You  can  use  >  and  <  to  compare  numbers  and  see  if  one  is  bigger  or 
smaller  than  the  other. 

*  The  ==,  !  =,  >,  and  <  are  called  conditional  operators.  When 
you  use  them  to  test  two  variables  or  values,  it’s  called  performing  a 

conditional  tests. 


When  you  use 
a  conditional 
operator  to 
compare  two 
numbers,  it’s 
called  a 

conditional  test. 


You  can  combine  individual  conditional  tests  into  one  long  lest  using 
the  &  &  operator  for  AND  and  the  |  |  operator  for  OR.  So  to  check  if 
i  equals  3  or  j  is  less  than  5,  do  ( i  =  3 )  II  ( j  <  5 ) . 


Set  a  variable  and  then  check  its  value 


Here’s  the  code  for  the  second  button.  It’s  an  if/else  statement 
that  checks  an  integer  variable  called  x  to  see  if  it’s  equal  to  10. 


Make  sure  you  stop  your  program  before 
you  do  ibis— the  |D£  won't  let  you  edit 
the  Code  while  the  program’s  running. 

You  dan  stop  it  by  dlosing  the  window, 
using  the  stop  button  on  the  toolbar,  or 
seledting  “Stop  Debugging"  from  the 
Debug 


menu. 


f"  irst  we  set 


up  a  variable 
tolled  x  and 
^ake  it  egual 
■fco  5.  Then  we 
dhedk  i£  ifs 
egual  to  10 


private  void  button2_Click (object  sender,  EventArgs  e) 


{ 


int  x 
if  (x 
1 


=  5; 

==  10) 


MessageBox.Show(”x  must  be 

1 

else 


10") ; 


( 

MessageBox.Show("x  isn't  10"); 

1 


) 


Here’s  the  output.  See  if  you  can  tweak  one  line 
of  code  and  get  it  to  say  “x  must  be  10”  instead. 
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it’s  all  just  code 


Add  another  conditional  test 


Tilt1  third  button  makes  this  output.  Now  make  a  change  to 
two  lines  of  rode  so  that  it  pops  up  both  message  boxes. 


This  line  dhedks  somel/alue  to 
see  i-f  it's  less  than 
■then  it  thetks  to  make  sure 
is  "Joe". 


name 


private  void  button3_Click (object  sender,  EventArgs  e) 
( 


int  someValue  =4; 

String  name  =  "Bobbo  Jr."; 

if  ((someValue  <  3)  &&  (name. Equals ("Joe") ) ) 

( 

MessageBox.Show("x  is  3  and  the  name  is  Joe"); 
I 

MessageBox. Show ("this  line  runs  no  matter  what"); 


Add  loops  to  your  program 

Here’s  the  code  for  the  last  button.  It's  got  two  loops.  The  first  is  a  while  loop,  which 
repeats  the  statements  inside  the  brackets  as  long  as  the  condition  is  true  do  something 
while  this  is  true.  The  second  one  is  a  for  loop.  lake  a  look  and  see  how  it  works. 


This  loop  keeps 
repealing  as  long  as 
the  Count  variable 
is  less  than  10. 


This  se-b  be  loop 
It  just  assigns  a 
value  to  the  integer 
that'll  be  used  in  it 


private  void  button4_Click (object  sender,  EventArgs  e) 
{ 


int  count  =  0; 

►while  (count  <  10) 

{ 

count  =  count  +  1; 

} 


The  second  part  the 
£or  statement  is  the  test 
|t  says  "W  as  long  as  i 
is  less  than  f«ve  the  loop 
should  keep  on  going  • 


for  ^int  i  =  QJ  i  <  5;  i++) 

{  ^ 

count  =  count  -  1; 

1 

MessageBox. Show ("The  answer  is  "  +  count), 


This  is  where  the  loop 
actually  does  something 
|*  this  case,  it  adds 
one  to  i  So  every  time 
the  loop  e*etutes,  it 
will  add  I  to  i- 


Before  you  click  on  the  button,  read  through  the  code  and  try  to  figure  out  what  the 
message  box  will  show.  Then  click  the  button  and  see  if  you  were  right! 
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over  and  over  and  over  and... 


SL  r  /  r 

k 


Let's  get  a  little  more  practice  with  conditional  tests  and  loops.  Take  a 
look  at  the  code  below.  Circle  the  conditional  tests,  and  fill  in  the  blanks 
so  that  the  comments  correctly  describe  the  code  that’s  being  run. 


int  result  =0;  //  this 
int  x  =  6;  //  declare  a 


variable  will  hold  the  final  result 
variable  x  and  >t  to 


W'  -filled  in  ike 
f  <«i  one  for 


you 


while  (x  >  3)  { 


//  execute  these  statements  as  long  as 


result  =  result  +  x;  //  add  x 


x  =  x  -  1;  //  subtract 

} 

for  (int  z  —  1 ;  z<3;  z=z+l)  { 

//  start  the  loop  by 
//  keep  looping  as  long  as 
//  after  each  loop, 
result  =  result  +  z;  // 

} 

//  The  next  statement  will  pop  up  a  message  box  that  says 

// . 

MessageBox. Show ("The  result  is  "  +  result); 


Alorc  about  dohditiohal  tests 

You  dan  do  simple  dondiiional  iesis  by  dkedkmg  ike  value  of  a  variable 
using  a  domparison  operator.  Here's  how  you  dompare  two  numbers,  *  and  y: 

x  <  y  (less  than) 
x  >  y  (greater  than) 

x  «  y  (equals— and  yes,  with  two  equals  signs) 

These  are  the  ones  you'll  use  most  often. 
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It’s  all  just  code 


Wait  up!  There's  a  flaw  in  your 
logic.  What  happens  to  my  loop  if  I 
write  a  conditional  test  that  never 
becomes  false? 


Then  your  loop  runs  forever! 

Every  time  your  program  runs  a  conditional  test,  the  result 
is  either  true  or  false.  If  it's  true,  then  your  program 
goes  through  the  loop  one  more  time.  Every  loop  should 
have  code  that,  if  it’s  run  enough  times,  should  cause 
the  conditional  test  to  eventually  return  false.  But  if  it 
doesn’t  then  the  loop  will  keep  running  until  you  kill  the 
program  or  turn  the  computer  olf!  ,  c all 


Here  are  a  few  loops.  Write  down  if  each  loop  will  repeat  forever  or 
eventually  end.  If  it's  going  to  end,  how  many  times  will  it  loop? 


Loop  #1 

int  count  =5; 
while  (count  >  0)  { 
count  =  count  *  3; 
count  =  count  *  -1; 


Loop  #2 

int  i  =  0; 
while  (i  ==  0)  { 

count  =  count  *  3; 
count  =  count  *  -1; 


Loop  #3 

int  j  =  2; 

for  (int  i  =  1;  i  <  100; 
i  =  i  *  2) 

{ 

j  =  j  "  if 
while  (j  <  25) 

{ 

j  =  j  +  5; 

1 

} 

Loop  #4 

while  (true)  {  int  i  ==  1 ;  > 


Loop  #5 

int  p  =  2; 

for  (int  q  =  2;  q  <  32; 
q  =  q  *  2) 

1 

while  (p  <  q) 

{ 

P  “  P  *  2; 

} 

q  =  p  -  q; 


r_  - 

Can  you  think  of  a  reason  that  you’d  want  to  write  a 
loop  that  never  stops  running? 


you  are  here  ► 


71 


if  only,  but  only  if 


Sharpen  your  pencil 
^  v  Solution 


Let's  get  a  little  more  practice  with  conditional  tests  and  loops.  Take  a 
look  at  the  code  below.  Circle  the  conditional  tests,  and  fill  in  the  blanks 
so  that  the  comments  correctly  describe  the  code  that's  being  run. 


int  result  =0;  //  this  variable  will  hold  the  final  result 
int  x  =  6;  //  declare  a  variable  x  and  set  it  "to  & 


while  0c  >  3j  { 


//  execute  these  statements  as  long  as  x  is  <yrcdb&r  than  3 


result  =  result  +  x;  //  add  x  bo  "the  result  variable 


x  =  x  -  1;  //  subtract 

* _ This  loop  wns  -twice — first  with  z.  set  to  I,  and 

then  a  second  time  with  z.  set  to  2-  OnCe  it  hits 

for  (int  z  *  1;  (z^<  3^  z  ■  z  +  1)  {  3,  j-fs  |or^er  less  than  3,  so  the  loop  stops 

//  start  the  loop  by  . . . . dedlarin^ A *: .$*4. li. .i(?.  .( . 

//  keep  looping  as  long  as  less  "tban  ^ 

//  after  each  loop,  add  I  bo  z. 

result  =  result  +  z;  //  .dd.d. . thfc . Vd IkiC. .9$. . £•. t». . 


//  The  next  statement  will  pop  up  a  message  box  that  says 

//  The  result  is  IG 


MessageBox. Show ("The  result  is  "  +  result); 


Sharpen  your  pencil 
^  ^  Solution 


Loop  #1 

This  loop  executes  once 


Loop  #2 

This  loop  runs  forever 


Here  are  a  few  loops.  Write  down  if  each  loop  will  repeat  forever  or 
eventually  end.  If  it's  going  to  end,  how  many  times  will  it  loop? 


Loop  #3 

This  loop  executes  7  times 

Loop  #4 

Another  infinite  loop 


Loop  #5 

This  loop 
executes  8  times, 
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it's  all  just  code 


there  j  ore  n<? 

Dumb  Questions 


Qj  Is  every  piece  of  code  always  in  a  class? 

Yes.  Any  time  a  C#  program  does  something,  it’s  because 
statements  were  executed.  Those  statements  are  a  part  of  classes, 
and  those  classes  are  a  part  of  namespaces  Even  when  it  looks 
like  something  is  not  a  statement  in  a  class— like  when  you  use 
the  designer  to  set  a  property  on  an  object  on  your  form — if  you 
search  through  your  code  you’ll  find  that  the  IDE  added  or  changed 
statements  inside  a  class  somewhere. 

Qj  Are  there  any  namespaces  I'm  not  allowed  to  use?  Are 
there  any  I  have  to  use? 

Yes.  there  are  a  few  namespaces  you’re  not  allowed  to  use. 
Notice  how  all  of  the  using  lines  at  the  top  of  your  C#  class 
files  always  said  System?  That’s  because  there’s  a  System 
namespace  that’s  used  by  the  NET  Framework.  It's  where  you 
find  all  of  your  important  tools  to  add  power  to  your  programs  Like 
System .  Data,  which  lets  you  work  with  tables  and  databases, 
and  System .  Math,  which  has  mathematical  functions.  But  for 
the  most  part,  you  can  choose  any  name  you  want  for  a  namespace 
(as  long  as  only  has  letters,  numbers  and  underscores).  When 
you  create  a  new  program,  the  IDE  will  automatically  choose  a 
namespace  for  you  based  on  the  program’s  name. 

Qj  I  still  don't  get  why  I  need  this  partial  class  stuff. 

Partial  classes  are  how  you  can  spread  the  code  for  one 
class  between  more  than  one  file.  The  IDE  does  that  when  it 
creates  a  form— it  keeps  the  code  you  edit  in  one  file  (like  Forml . 
cs),  and  the  code  it  modifies  automatically  for  you  in  another  file 
(Form  1. Designer  cs).  You  don't  need  to  do  that  with  a  namespace, 
though.  One  namespace  can  span  two,  three  or  a  dozen  or  more 
files.  Just  put  the  namespace  declaration  at  the  top  of  the  file,  and 
everything  within  the  curly  brackets  after  the  declaration  is  inside 
the  same  namespace.  One  more  thing:  you  can  have  more  than  one 
class  in  a  file.  And  you  can  have  more  than  one  namespace  in  a  file. 
You’ll  learn  a  lot  more  about  classes  in  the  next  few  chapters. 

o 

Let's  say  I  drag  something  onto  my  form,  so  the  IDE 
generates  a  bunch  of  code  automatically.  What  happens  to  that 
code  if  I  click  “Undo"? 

The  best  way  to  answer  this  question  is  to  try  it!  Give  it  a 
shot— do  something  where  the  IDE  generates  some  code  for  you. 


Drag  a  button  on  a  form,  change  properties.  Then  try  to  undo  it.  What 
happens?  Well,  for  simple  things  what  you'll  see  is  that  the  IDE  is 
smart  enough  to  undo  it  itself.  But  for  more  complex  things,  like 
adding  a  new  SQL  database  to  your  project,  you’ll  be  given  a  warning 
message.  It  still  knows  how  to  undo  the  action,  but  it  may  not  be  able 
to  redo  it. 

Q:  So  exactly  how  careful  do  I  have  to  be  with  the  code  that's 
automatically  generated  by  the  IDE? 

You  should  generally  be  pretty  careful.  It’s  really  useful  to 
know  what  the  IDE  is  doing  to  your  code,  and  once  in  a  while  you'll 
need  to  know  what’s  in  there  in  order  to  solve  a  serious  problem.  But 
in  almost  all  cases,  you’ll  be  able  to  do  everything  you  need  to  do 
through  the  IDE. 

BULLET  POINTS - 1 


■  You  tell  your  program  to  perform  actions  using 
statements  Statements  are  always  part  of  classes,  and 
every  class  is  in  a  namespace. 

■  Every  statement  ends  with  a  semicolon  ( ; ) 

■  When  you  use  the  visual  tools  in  the  Visual  Studio  IDE, 
it  automatically  adds  or  changes  code  in  your  program. 

■  Code  blocks  are  surrounded  by  curly  braces  {  } . 
Classes,  while  loops,  if/else  statements  and  lots  of 
other  kinds  of  statements  use  those  blocks. 

■  A  conditional  test  is  either  true  or  false.  You  use 
conditional  tests  to  determine  when  a  loop  ends,  and 
which  block  of  code  to  execute  in  an  if/else  statement. 

■  Any  time  your  program  needs  to  store  some  data,  you 
use  a  variable.  Use  =  to  assign  a  variable,  and  ==  to 
test  if  two  variables  are  equal 

■  A  while  loop  runs  everything  within  its  block  (defined 
by  curly  braces)  as  long  as  the  conditional  test  is 

true. 

■  If  the  conditional  test  is  false,  the  while  loop  code 
block  won’t  run,  and  execution  will  move  down  to  the 
code  immediately  after  the  loop  block. 
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your  code...  now  in  magnet  form 


Code  Magnets 


LPart  of  a  C#  program  is  all  scrambled  upon  the  fridge.  Can  you 
rearrange  the  code  snippets  to  make  a  working  C#  program  that 
1  produces  the  message  box?  Some  of  the  curly  braces  fell  on  the 
floor  and  they  were  too  small  to  pick  up,  so  feel  free  to  add  as  many 
of  those  as  you  need!  r—~ — 

TV  ""  is  an  empty  s-brin^ — i-fc.  means  / 

Result  has  no  Chavactetrs  in  it  yet  j  / 


it’s  all  jus:  code 


(Ve'll  give  you  a  lot  of  exercises  like  th.s  throughout  the  book.  We'll 
give  you  the  answer  in  a  Couple  of  pages  |f  you  get  stuck,  don't  be 
a+raid  to  peek  at  the  answer— it's  not  cheating/ 


Time  to  get  some  practice  using  if/else  statements.  Can  you  build  this  program? 


Here’s  the  form. 


\ 


Fun  with  if/else  statements! 


Change  the  color  if  the 
box  is  checked 


[✓1  Enable  color  changing 


Press  the  button  to  change  my  color 


Add  this  checkbox. 

Drag  it  out  of  the  toolbox  and  onto  your 
form.  Use  die  Text  property  to  change  the 
text  that’s  next  to  it.  (You  also  use  the  Text 
property  to  change  the  button  and  label  text.) 


This  is  a  label. 

You  can  use  die  properties  to  change  the 
font  size  and  make  it  boldface.  Use  the 
BackColor  property  to  set  to  red — choose 
“Red  "  from  the  selection  of  web  colors. 


Pop  up  this  message  if  the  user  clicks  the  button  but  the 
box  IS  NOT  checked. 

If  your  checkbox  is  named  checkBoxl  (you  can  change  the  Name  property 
if  you  want),  then  here’s  the  conditional  lest  to  see  if  it’s  checked: 

checkBoxl . Checked  ==  true 


If  the  user  clicks  the  button  and  the  box  IS  checked,  change  the 
background  color  of  the  label. 

If  the  label  background  color  is  red,  change  it  to  blue  when  the  button  is  clicked.  If  it’s  blue, 
change  it  back  to  red.  Here’s  a  statement  that  sets  the  background  color  of  a  label  called  labell: 

label 1 .BackColor  =  Color. Red; 

(Hint:  The  conditional  test  to  check  whether  a  label’s  background  color  is  red  looks  a  lot  like  that 
statement — but  with  one  important  difference!) 
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ooh,  pretty! 


Exercise 


Let's  build  something  flashyl 


Here's  the  form  to  build 


’T"  t*Cwi‘iS  m£  “ to.  a«!« 


Make  the  form  background  go  all  psychedelic! 

When  the  button’s  clicked,  make  the  form’s  background 
color  cycle  through  a  whole  lot  of  colors!  Create  a  loop  that 
has  a  variable  c  go  from  0  to  254.  Here’s  the  block  of  code 
that  goes  inside  the  curly  brackets: 


this.BackColor  =  Color .FromArgb (c,  255  -  c,  c) ; 


Application . DoEvents i 


<-) 


Etl 

bo.  to  £|«,  tho  .1N|J  *•  £li£k»s  tt«  x 


Make  it  slower 

Slow  down  the  flashing  by  adding  this  line  before 
the  Application .  DoEvents  ( )  line: 


System. Threading. Thread. Sleep (3) ; 


cm  - 

ict  uas  a  ^  u  4  a^40 

w  ,  a*dM'Wt  a 

Colors  W»  *“ 

1C.  Colot  U»yS  3  vtd 

the  ^UJ-  1 .  eC  r.vrrsoe'r^ 

,aU.a^ce  — 


This  statement  wserb  a  *  mtlhsetond 

dela^  •»»  the  looy  It*  a  ?  r 

the  W  for**  and  'ts-n  the 

System. Threading  names?a« 
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You  II  be  treating  a  lot  of  applications  throughout  this  book,  and 
you'll  need  to  Jive  each  one  a  different  name  We  recommend  naming 
this  one  "Z  Fun  with  if -else  statements"  based  on  the  chapter 

Make  it  smoother  hU"’be'r  a"d  he  M  '*  tKe  ba,r  ^  ^ 

Let’s  make  the  colors  cycle  back  to  where  they  started.  Add  another  loop  that  has 
c  go  front  254  down  to  0.  Lise  the  same  block  of  code  inside  the  curly  brackets. 


Keep  it  going  When  one  loop  is 

Surround  your  two  loops  with  another  loop  that  continuously  executes  and  doesn't  inside  another 
stop,  so  that  when  the  button  is  pressed,  the  background  starts  changing  colors  and  one,  we  call  it  a 
then  keeps  doing  it.  (Hint:  The  while  (true)  loop  will  run  forever!)  ./  nested”  loop 


Uh-oh!  The  program  doesn't  stop! 

Run  your  program  in  the  IDE.  Start  it  looping.  Now  close  the  window.  Wait  a 
minute — the  IDE  didn't  go  back  into  edit  mode!  It’s  acting  like  the  program 
is  still  running.  You  need  to  actually  stop  the  program  using  the  square  stop 
button  in  the  IDE  (or  select  “Stop  Debugging”  from  the  Debug  menu). 


O 


Make  it  stop 

Make  the  loop  you  added  in  step  #5  stop  when  the  program  is 
closed.  Change  your  outer  loop  to  this: 

while  (Visible) 

low  run  the  program  and  click  the  X  box  in  the  corner.  The 
window  closes,  and  then  the  program  stops!  Except...  there’s  a 
delay  of  a  few  seconds  before  the  IDE  goes  back  to  edit  mode. 
When  you're  checking  a  boolean  value  like  Visible 
in  an  if  statement  or  a  loop,  sometimes  it's 
temp-ting  to  test  for  (Visible  ==  true). 

Y°vi  can  leave  off  the  —  true”— its  enough  to 
include  the  boolean 


“AND”  ir  l  °?eraU  ***** 

of  eo«U*  h<iV?  S^ir’9  a 

T  W^her  into 

W  t  J -ly  if  the 

ie*“  AND  the  second 

oof;'  A *  ** d .  Ch.  And 
t  II  Come  in  handy  to  sob*  ik:. 
problem. 


i>dy  to  solve  this 


When  you  re  working  with  a 
form  or  Control,  1/isible  is 
true  as  long  as  the  form  or 
Control  is  being  displayed.  |f 
you  set  it  to  false,  it  makes 
the  form  or  Control  disappear 


Can  you  figure  out  what’s  causing  that 
delay?  Can  you  fix  it  so  the  program  ends 
immediately  when  you  close  the  window? 
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exercise  solution 


ExcrciS 

§OLyt\ 


Time  to  get  some  practice  using  if/else  statements.  Can  you  build  this  program? 

‘RciSe 

iyitOH  Here’s  the  entire  Forml  6s  -file  -for  the  F un  with 

using  System;  |f/Else  Statements!"  e*crdise  If  we  show  you  a 

using  System. Collections. Generic;  of  Code  in  a  file  like  this,  we'll  draw  a  jrey 


using  System. ComponentModel; 

using  System. Data; 

using  System. Drawing; 

using  System. Linq; 

using  System. Text; 

using  System. Windows. Forms; 


bo*  behind  the  part  that  you  should  add 


namespace  Fun_with_If_Else 


Here's  the  dode  *Por  the  form.  We  named  our  solutio 
"Fun  with  |f  Else'  ’,  so  the  IDE  made  the  namespade 

F un _ with__|f _ Else  |f  you  gave  you r  solution  a 

y  different  name,  it’ll  have  a  different  namespade 


public  partial  class  Forml  :  Fi 
( 

public  Forml () 

{ 

InitializeComponent () ; 


The  IDE  added  the  method  dalled 
button/_ClidkO  to  your  form 
when  you  double-dlidked  on  the 
button.  The  method  jets  run 
every  time  the  button's  dlidked- 


The  outer  if  / 
statement  dhedks 
the  dhedkbo*  to 
see  if  it’s  been 
dhedked  Chedkl 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


lif  (checkBoxl .Checked  ==  true) 

{ 

if  (labell .BackColor  =  Color. Red) 

{ 

labell .BackColor  =  Color. Blue; 

) 

else 


The  inner  if  statement 
dhedks  the  label's 
dolor.  |f  the  label 
is  durrently  red,  it 
e*edutes  a  statement 
to  turn  it  blue 


labell . BackColor  =  Color. Red; 


MessageBox. Show ("The  box  is  not  checked") 


This  statement's 
run  if  the  label's 
badkjround  dolor  is 
not  red  to  make  it 
set  badk  to  red 


This  WlessajeBo*  pops  up  if 
the  dhedkbo*  isn't  dhedked 


You  can  download  the  code  for  all  of  the  exercise  solutions 
in  this  book  from  www.headfirstlabs.com/books/hfcsharp/ 
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Exercise 

S°Lytioi 


Let's  build  something  flashy! 


©OLutlOH 

Sometimes  we  won't  show  you  the  entire  Code 

rn  tfce  solution,  iust  the  b-ts  that  charged  All  Men  the  IDE  added  this  method,  it  added  an  e*tra 

Lii  I  ^  “  '*  th,s  return  before  the  Curly  bracket  Sometimes  we'll  put  the 

a"u  7?"d1  ^  ^  r  addrd  wKe"  bracket  on  the  same  line  like  this  to  save  space-but  C# 

you  double-clicked  the  button  m  the  term  designer  doesn't  tare  about  e*tra  space,  so  this  is  perfectly  valid- 

*  >£T 

private  void  buttonl  Click  (object  sender,  EventArgs  e)T  ( 

^-^while  (Visible)  {  / 


The  outer  loop  for  (int  c  =  0;  c  <  254  &&  Visible;  C++) ( {  ) 

keeps  running  as  ^ ' 

long  as  the  form  thi s . BackColor  =  Color .  FromArgb  (c,  255  -  c,  c)  ; 

is  visible-  As  soon  tl  r  i  r 

as  it's  closed,  Application .  DoEvents  ( )  ;  he  +Mrst  1 

Visible  is  -false  ^  toJors  on, 

and  the  h  i  *  System  .Threading .  Thread.  Sleep  (3 )  ;  second  W  loop 

will  stop  looping.  }  *°  ^  ,ook  ^ 


Application .  DoEvents  ( )  ;  f'«t  -for  loop  makes  the 

V  Colo rs  cycle  one  way,  and  +h. 

System. Threading. Thread. Sleep  (3)  ;  second  -for  Up  +.J.  ,, 

r  .  il  i  ,  '  r«vtrses  them 

10  they  look  Smooth 


for  (int  c  =  254;  c  >=  0  &&  Visible;  c--)  { 

this . BackColor  =  Color . FromArgb (c,  255  -  c,  c) ; 


Application. DoEvents () ; 

System. Threading. Thread. Sleep (3) ; 


VVe  f*ed  the  e^tra  delay  by 
using  the  &&  operator  to  make 
each  of  the  for  loops  also  chetk 
Visible-  That  way  the  loop  ends 
as  soon  as  Visible  turns  false 


Can  you  figure  out  what’s  causing  that  dS  soon  « 
delay?  Can  you  fix  it  so  the  program  ends 
immediately  when  you  close  the  window? 

The  delay  happens  because  the  tor  loops  need  to  finish  before  the 
while  loop  can  check  if  Visible  is  still  true.  You  can  fix  it  by  adding 
&&  Visible  =  true  to  die  conditional  test  in  each  for  loop. 

Was  your  code  a  little  different  tlian  ours?  There’s  more  than  one  way 
to  solve  airy  programming  problem— like  you  could  have  used  vhile  loops 
instead  of  for  loops.  If  your  program  works,  then  you  got  the  exercise  ri  ghi! 
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this  puzzle’s  tougher  than  it  looks 


Poo]  puzzle 


Your  job  is  to  take  code  snippets  from 
the  pool  and  place  them  into 
the  blank  lines  in  the  code.  You 
may  not  use  the  same  snippet 
more  than  once,  and  you  won't 
need  to  use  all  the  snippets. 
Your  goal  is  to  make  a  class 
that  will  compile  and  run.  Don't 
be  fooled — this  one's  harder  than  it 
looks. 


using  System; 

using  System. Windows. Forms; 
namespace  Chapter_2  ( 

class  Chapter2PoolPuzzle  { 
public  static  void  MainO  { 
int  x  =  0; 

String  Poem  = 

while  (  _  )  { 


if  (  x  <  1  )  { 


Output 


We  ^eluded  these  "Pool  Puzzle”  exercises  throughout  the  book 
to  give  your  bram  an  extra-tough  workout  If  you’re  the  kind 
of  person  who  loves  twisty  little  logic  puzzJes,  then  you’ll  love 
this  one-  If  you’re  not,  give  it  a  shot  anyway— but  don’t  be 
afraid  to  look  at  the  answer  to  f  igure  out  what’s  going  on. 
And  if  you’re  stumped  by  a  pool  puzzJe,  def  initely  move  on. 


Note:  each  snippet 
from  the  pool  can  only 
be  used  once! 


x  =  x  +  1 ; 
x  =  x  +  2; 
x  =  x  -  2; 
x  =  x  -  1; 


Poem  =  Poem  +  ”noys 
Poem  =  Poem  +"oise  "; 
Poem  =  Poem +"  oyster"; 
Poem  =  Poem  +  "annoys"; 
Poem  =  Poem  +  “noise"; 


it's  all  just  code 


Csharpcross 

How  does  a  crossword  help  you  learn  C#?  Well,  all  the  words  are  C#- 
related  and  from  this  chapter.  The  clues  also  provide  mental  twists  and 
turns  that  will  help  you  burn  alternative  routes  to  C#  right  into  your  brain 


Across 

3  You  give  information  to  a  method  using  these 

4.  buttonl.Text  and  checkBox3.Name  are  examples  of 

8.  Every  statement  ends  with  one  of  these 

10.  The  name  of  every  C#  program’s  entry  point 

11  Contains  methods 

12.  Your  statements  live  here 

14  A  kind  of  variable  that’s  either  true  or  false 

15.  A  special  method  that  tells  your  program  where  to 

start 

16  This  kind  of  class  spans  multiple  files 


Down 

1  The  output  of  a  method  is  its _ value 

2.  System. Windows. Forms  is  an  example  of  one  of 
these 

5.  A  tiny  piece  of  a  program  that  does  something 

6.  A  block  of  code  is  surrounded  by 

7  The  kind  of  test  that  tells  a  loop  when  to  end 

9.  You  can  call _ .ShowQ  to  pop  up  a  simple 

Windows  dialog  box 

13.  The  kind  of  variable  that  contains  a  whole  number 


you  are  here  ► 
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exercise  solutions 


Code  Magnets  Solution 

Part  of  a  C#  program  is  all  scrambled  up  on  the  fridge. Can  you 
rearrange  the  code  snippets  to  make  a  working  C#  program  that 
produces  the  message  box?  Some  of  the  curly  braces 

- fell  on  the  floor  and  they  were  too  small  to  pick  up, 

so  feel  free  to  add  as  many  of  those  as  you  need! 


string 


Result  = 


Thi,  £l( 

off  the  Aidge... 


int  x  =  3; 


while  (x  >  0)  t 


The  first  We  through  the 
loof ,  *  is  e<\ual  to  3  so  this 
Conditional  test  will  be  true. 


if  (W>2)J\ 

Result  =  Result  +  "a"*’ 


X  -  1; 


Result  = 


Result  +  «_«. 


2"  *•* tht  t»« 


f if  fxTT 

Result  a  , 


isu-lt  + 


MessageBox . Show (Result) ; 
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it’s  all  jusr  code 


poo]  Plizzjc  ^oJtffjoH 

Your  job  was  to  take  code  snippets  from  the 
pool  and  place  them  into  the  blank  lines 
in  the  code.  Your  goal  was  to  make  a 
class  that  will  compile  and  run. 


using  System; 

using  System. Windows . Forms; 
namespace  Chapter_2  { 

class  Chapter2PoolPuzzle  ( 
public  static  void  Main() 
int  x  =  0; 

String  Poem  = 


while  (  x  <  4  )  { 


Poem  =  Poem  ♦  “a"; 

if  (  x  <  1  )  { 

Poem  =  Poem  ♦  “ 

} 

Poem  =  Poem  +  “n“; 

if  (  x  >  1  )  { 

Poem  =  Poem  +  “  oyster"; 
x  =  x  ♦  2; 

) 

if  (  x  —  1  )  { 

Poem  =  Poem  +  “noys 

} 

if  (  x  <  1  )  { 


Poem  =  Poem  ♦  "oise  **; 

} 


x  =  x  +  1; 

) 

MessageBox .  Show(Poem); 

) 

} 

) 


you  are  here  * 
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crossword  solution 


Csharpcross  Solution 
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.  and  that's  why  my 
Husband  class  doesn't  have  a 
HelpOutAroundTheHouse() 
method  or  a 

PullHisOwnWeightQ  method. 


3  objects:  get  oriented! 

Making  Code  Make  Sense  + 

Jr 


Every  program  you  write  solves  a  problem. 

When  you're  building  a  program,  it's  always  a  good  idea  to  start  by  thinking  about  what 
problem  your  program’s  supposed  to  solve.  That’s  why  objects  are  really  useful.  They 
let  you  structure  your  code  based  on  the  problem  it’s  solving,  so  that  you  can  spend  your 
time  thinking  about  the  problem  you  need  to  work  on  rather  than  getting  bogged  down  in 
the  mechanics  of  writing  code  When  you  use  objects  right,  you  end  up  with  code  that's 
intuitive  to  write,  and  easy  to  read  and  change 


this  is  a  new  chapter  85 


mike’s  going  places 


How  Mike  thinks  about  his  problems 

Mike’s  a  programmer  about  to  head  out  to  a  job 
interview.  He  can’t  wait  to  show  oft  his  C#  skills,  but 
first  he  has  to  get  there — and  he’s  running  late! 


Mike  figures  out  the  route  he'll  take  to  get  to  the  interview. 


* 


Good  thing  he  had  his  radio  on.  There’s 
a  huge  traffic  jam  that'll  make  him  late! 


Mtceyb**"  , 

3brt  a-d 

street  V*  _ 


This  is  Frank  Loudly  with 
your  eye-in-the-sky  shadow  traffic 
report.  It  looks  like  a  three-car 
pileup  on  Liberty  has  traffic  backed 
up  all  the  way  to  32nd  Street. 


Mike  comes  up  with  a  new  route  to  get 
to  his  interview  on  time. 


Now  he  C3r>  Come  uj> 
wifh  a  new  route  to 
the  interview. 
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objects:  get  oriented! 


How  Mike's  car  navigation  system  thinks  about  his  problems 


Mike  built  his  own  ( d’S  navigation  system,  which  he 
uses  to  help  him  get  around  town. 


Here’s  a  diagram  of  a  class 
in  Mike's  yrogram  It  shows 
the  name  on  toy,  and  the 
methods  on  the  bottom 


SetDestination ("Fifth  Ave  &  Penn  Ave"); 
string  route;  here’s  ^tyut  from  the 

route  =  GetRoute ( ) ; 


^etRovteO  method-ts 

a  string  that  Contains  the 
directions  Mike  should  follow- 


Navigator 


SetDestination() 
ModifyRouteToAvoid() 
ModifyRouteTolnclude( ) 
GetRoute() 

GetTimeToDestination() 

TotalDistanoe() 


The  navigation  system  sets 
a  destination  and  Comes  uf 
with  a  route 


"Take  31St  Street  Bridge  to  Liberty  Avenue  to  Bloomfield" 


The  navigation  system  gets 
new  information  about  a 
street  it  needs  to  avoid 

Modi fyRouteToAvoid( "Liberty  Ave") ; 


,  e  u?  vj.th  a  n*« 
tp  the  destination 


string  route; 
route  =  GetRoute ( ) ; 


"Take  Route  28  to  the  Highland  Park  Bridge  to  Washington  Blvd" 

<$eiRouie()  gives  a  new  route 
that  doesn't  include  the 
street  Mike  wants  to  avoid 

Mike’s  navigation  system  solves  tke  street 
problem  tke  same 


navigation 
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set  methods  and  modify  routes 


Mike's  Navigator  class  has  methods  to  set  and  modify  routes 


Mike’s  Navigator  class  has  methods,  which  are  where  the  action  happens.  Blit  unlike 
the  button  Click  ( )  methods  in  the  forms  you’ve  built,  they’re  all  focused  around 
a  single  problem:  navigating  a  route  through  a  city.  That’s  why  Mike  stuck  them 
together  into  one  class,  and  called  that  class  Navigator. 


Mike  designed  his  Navigator  class  so  that  it’s  easy  to  create  and  modify  routes.  To 
get  a  route,  Mike's  program  calls  the  SetDestination  ( )  method  to  set  the 
destination,  and  then  uses  the  GetRoute  ( )  method  to  put  the  route  into  a  string. 
If  he  needs  to  change  the  route,  his  program  calls  the  Modif  yRouteToAvoid  ( ) 
method  to  change  the  route  so  dial  it  avoids  a  certain  street,  and  then  calls  die 
GetRoute  ( )  method  to  get  the  new  directions. 

public  class  Navigator ()  { 


/VI  ike  those  method  names  that 
would  make  sense  to  someone 
who  was  thinking  about  how  to 
navigate  a  route  through  a  tity 


public  void  SetDestination (string  destinationName)  {  ...  }; 
public  void  Modif yRouteToAvoid (string  streetName)  {  ...  }; 
public  (string\  GetRoute  ()  {  ...  }; 


~  "'v  vnv 

Some  methods  have  a  return  value 

p _  .1  i  *  i  i-  .  .  .  i 


muUe  tkjt  „ll  “*  '*  Ki  1 

M  “““ *  ■*»-  *■  ** 


Every  method  is  made  up  of  statements  that  do  things.  Some  methods  just  execute 
their  statements  and  then  exit.  But  other  methods  have  a  return  value,  or  a  value 
that’s  calculated  or  generated  inside  the  method,  and  sent  back  to  the  statement  that 
called  that  method.  The  type  of  the  return  value  (like  string  or  int)  is  called  the 

return  type. 


string  route; 
route  =  GetRoute ( ) ; 


Here’s  an  e*ample  of  a  method 
that  has  a  return  type— >t 
returns  an  int  The  method 
uses  the  two  parameters  to 
tabulate  the  result  and  uses 
the  return  statement  to  pass 
the  value  batk  to  the  statement 
that  tailed  it 


The  return  statement  tells  ihe  method  to  immediately  exit.  If  your  method  doesn’t 
have  a  return  value  which  means  it’s  declared  with  a  return  type  of  void  then 
the  return  statement  just  ends  with  a  semicolon,  and  you  don’t  always  have  to 
have  one  in  your  method.  But  if  the  method  has  a  return  type,  then  it  must  use  the 
return  statement. 

public  int  MultiplyTwoNumbers (int  firstNumber,  int  secondNumber)  { 
int  result  =  firstNumber  *  secondNumber; 
return  result; 

*  IWods  tan  take  values  like 

Here’s  a  statement  that  calls  a  method  to  multiply  two  numbers.  It  returns  an  int:  ^  ^  ^  ^  tan  also  pass 

int  myResult  =  MultiplyTwoNumbers (3,  5);  - — ^  gables  to  them- 
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objects:  get  oriented! 


Use  what  you've  learned  to  build  a  simple  application 


Let’s  hook  up  a  form  to  a  class,  and  make  its  button 
call  a  method  inside  that  class. 


/^"^Do  tliis! 


+ 


Create  a  new  Windows  Application  project  in  the  IDE.  Then  add  a  class  file  to  it  called 
Talker .  cs  by  right-clicking  on  the  project  in  the  Solution  Explorer  and  selecting  “Class...” 
from  the  Add  menu.  When  you  name  your  new  class  file  “Talkcr.cs”,  the  IDE  will  automatically 
name  the  class  in  the  new  file  Talker.  Then  it’ll  pop  up  the  new  file  in  a  new  tab  inside  the  IDE. 
Add  using  System.  Windows .  Forms;  to  the  top  of  the  class  file.  Then  add  code  to  the  class: 


class  Talker  { 

public  static  int  BlahBlahBlah (string 
This  sUbewCftt  ^string  finalstring  = 
declares  a  {malSbri**  for  (int  count 

variable  * 

e<\«al  to  an  e» 
string 


thingToSay,  int  numberOfTimes)  { 


1;  count  <=  numberOfTimes;  count++) 
finalstring  =  finalstring  +  thingToSay  +  "\n"; 


< 


} 

MessageBox . Show (finalstring) 
return  finalstring. Length; 


The  BlahBlahBlahO  method's  return  value  is 
an  integer  that  has  the  total  length  of  the 
essa^e  it  displayed  You  tan  add  Length 
to  any  string  to  f  igure  out  how  long  it  is. 


The  new  class  has  one  method  called  BlahBlahBlah  ( )  that  takes  two  parameters.  'Die  first 
parameter  is  a  string  that  tells  it  something  to  say,  and  the  second  is  the  number  of  times  to  say  it. 

When  it’s  called,  it  pops  up  a  MessageBox  with  the  message  repated  a  number  of  times.  Its  return 
value  is  the  length  of  the  string  The  method  needs  a  string  for  its  thingToSay  parameter  and  a  number 
of  its  numberOfTimes  parameter.  It’ll  get  those  parameters  from  a  form  that  lets  the  user  enter  text 
using  a  TextBox  control  and  a  number  using  NumericUpDown  control. 


Set  the  default  tent  of  the  TentBon 
to  "Hello!"  using  its  Tent  property 


O  Add  this  form  to  your  project. 


Then  double-click  on  the  button  and  have  it  run  this  code: 

int  len  =  Talker. BlahBlahBlah (textBoxl. Text,  (int)  numericUpDownl .Value) ; 


MessageBox. Show ("The  message  length  is  "  +  len); 

Now  run  your  program!  Click  the  button  and  watch  it  pop  up  two 
message  boxes.  The  class  pops  up  the  first  message  box,  and  the 
form  pops  up  the  second  one. 


The  BlahBlahBlahO  method 
pops  up  this  message  bon 
based  on  what’s  in  its 
parameters. 


When  -the 
method  returns 
a  value,  the  form 
pops  it  up  in  this  _ 

message  bon  V/* 


This  is  a  NumericUpDown 
Control.  Set  its  Minimum 
property  to  I,  its  Manimum 
property  to  10,  and  its 
l/alue  property  to  3. 


you  are  here  ► 


89 


introducing  objects 


Mike  gets  ax  idea 

The  interview  went  great!  Bui  the  traffic 
jam  this  morning  got  Mike  thinking  about 
how  lie  could  improve  his  navigator. 


It'd  be  great  if  I 
could  compare  a  few 
routes  and  figure  out 
which  is  fastest... 


He  could  create  three  different  Navigator  classes... 

Mike  could  copy  the  Navigator  class  code  and  paste  it  into  two  more  classes. 
Then  his  program  could  store  three  routes  at  once. 


Navigator 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoutef) 

GetTimeToDestinationQ 

TotalDistance() 


Navigator2 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDestination() 

TotalDistanceO 


This  bo*  is  a  class  diagram  It  l'*t* 
all  ©f  the  methods  in  a  class,  and 
it's  an  easy  way  to  see  everything 
that  it  does  at  a  glance-  \ 

Navigator3  \ 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDestination() 

TotalDistanceO 


Whoa,  that  can’t  be  right! 
What  if  I  want  to  change  a 
method?  Then  I  need  to  go 
back  and  fix  it  in  three  places. 


Right!  Maintaining  three  copies  of  the  same  code 
is  really  messy.  A  lot  of  problems  you  need  to  solve  need  a 
way  to  represent  one  thing  a  bunch  of  different  times.  In  this  case, 
it’s  a  bunch  of  routes.  But  it  could  be  a  bunch  of  turbines,  or  dogs, 
or  music  files,  or  anything.  All  of  those  programs  have  one  tiling  in 
common:  they  always  need  to  treat  the  same  kind  of  tiling  in  the 
same  way,  no  matter  how  many  of  the  thing  they’re  dealing  with. 
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objects:  get  oriented! 


Mike  can  use  objects  to  solve  his  problem 


Objects  are  C'#rs  tool  that  you  use  (o  work  with 
a  bunch  of  similar  things.  Mike  can  use  objects 


has  all  of  the  methods  from  that  class. 


you  are  here  ► 
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for  instance... 


You  use  a  class  to  build  aw  object 

A  class  is  like  a  blueprint  for  an  object  .  If  you  wanted  to  build 
live  identical  houses  in  a  suburban  housing  development,  you 
wouldn't  ask  an  architect  to  draw  up  five  identical  sets  of 
blueprints.  You’d  just  use  one  blueprint  to  build  five  houses. 


Am  object  gets  its  methods  from  its  class 


Once  you  build  a  class,  you  can  create  as  many  objects  as  you  want  from 
it  using  the  new  statement.  When  you  do,  every  public  method  in  your 
class  becomes  part  of  the  object. 


House 


GiveShelter() 

AppreciatelnValue() 

GrowLawn() 

MailDelivered() 

ClogDrainPipes() 

AccruePropertyTaxes() 

NeedRepairs() 


92  Chapter  3 


objects:  get  oriented! 


When  you  create  a  new  object  from  a  class, 
it's  called  an  instance  of  that  class. 

Guess  what...  you  already  know  this  stuff!  Everything  in  die  toolbox 
is  a  class:  there’s  a  Button  class,  a  TextBox  class,  a  Label 
class,  etc.  When  you  drag  a  button  out  of  the  toolbox,  the  IDE 
automatically  creates  an  instance  of  the  Button  class  and  calls 
it  buttonl.  When  you  drag  another  button  out  of  the  toolbox, 
it  creates  another  instance  called  button2.  Each  instance  of 
Button  has  its  own  properties  and  methods.  But  every  button  acts 
exactly  the  same  way,  because  they’re  all  instances  of  the  same  class. 


Before:  Here's  a  picture  of  your 
Computer's  memory  when  your 

program  starts 


four  program 
executes  a  new 
statement. 


House  115MapleDrive  =  new  House (); 


Check  it  out  for  yourself! 


After:  No " 

got  dn  instance 
5  the  House 
tlass  in  memory 

V 


Do  tMs! 


Open  any  project  that  uses  a  button  called  buttonl,  and 
use  the  IDE  to  search  the  entire  project  for  the  text  “new 
buttonl”.  You’ll  find  the  code  that  the  IDE  added  to  the 
form  designer  to  create  the  instance  of  the  Button  class. 


+ 


in-stance,  noun. 

an  example  or  one  occurrence 
of  something.  The  IDE  search- and  - 
replace  feature  finds  every  instance 
°J  a  word  and  changes  it  to  another. 


you  are  here  ► 
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objects  improve  your  code 


A  better  solution...  brought  to  you  by  objects! 

Mike  came  up  with  a  new  route  comparison  program  that  uses  objects  to  find 
the  shortest  of  three  different  routes  to  the  same  destination.  Here’s  how  he 
built  his  program. 


stdhds  -for  graphical 
Wser  Inlerface,  whrdb  is 
xhat  you're  building  when 

you  make  a  -form  in 
rorm  designer 


O 

o 


Mike  set  up  a  GUI  with  a  text  box  textBoxl  contains  die  destination  for  die  diree 
routes.  Then  he  added  textBox2,  which  lias  a  street  that  one  of  the  routes  should  avoid;  and 
textBox3,  which  contains  a  difierent  street  that  the  third  route  has  to  include. 


He  created  a  Navigator  object  and  set  its  destination. 


Navigator 


SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDesti  nation( ) 
TotalDistance() 


(navigatorl' 

3.5  miles 

o<“ 


The  navi^a-tovl 
object  is  an 
instance  of  the 
b/avi^ator  class 


String  destination  =  textBoxl .Text; 
Navigator  navigatorl  =  new  Navigator ( ) 
navigatorl . SetDestination (destination) ; 
route  =  navigatorl . GetRoute ( ) ; 


then  he  added  a  second  Navigator  object  called  navigator2.  He 
called  its  SetDestination  ( )  method  to  set  the  destination,  and 
then  he  called  its  Modif  yRouteToAvoid  ( )  method. 


The  third  Navigator  object  is  called  navigator3.  Mike  set  its  / 
destination,  and  then  called  its  Modif  yRouteToInclude  ( )  methotr 


Now  Mike  can  call  each  object’s  TotalDistance  ( )  method  to  figure 
out  which  route  is  the  shortest.  And  he  only  had  to  write  the  code  once, 
not  three  times! 


Sgssssr4 


Any  time  you 
create  a  new 
object  Irom 
a  class,  it’s 
called  creating 
an  instance  of 
that  class. 
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Follow  the  same  steps  that  Mike  followed  on  the  facing  page  to  write 
the  code  to  create  Navigator  objects  and  call  their  methods. 


String  destination  =  textBoxl . Text;  V 

String  route2StreetToAvoid  =  textBox2 .Text;  > 
String  route3StreetTo!nclude  =  textBox3 . Text; 


We  save  you  a  head  start  Here's 
the  Code  Alike  wrote  to  jet  the 
destination  and  street  names  from 
the  textboxes. 


Navigator  navigator 1  =  new  Navigator ()  j 
navigatorl . SetDestination (destination)  ;  'S 
int  distancel  =  navigatorl .TotalDistance ( ) ; 


And  here's  the  Code  to  create  the 
navigator  object,  set  its  destination, 
and  $et  the  distance 


1 .  Create  the  navigator2  object,  set  its  destination,  call  its  ModifyRouteToAvoidO  method,  and  use  its 
|  TotalDistance!)  method  to  set  an  integer  variable  called  distance2. 

Navigator  navigator2  = 


I  navigator2 . 

I  navigator2 . 

I  int  distance2  = 


2.  Create  the  navigator3  object,  set  its  destination,  call  its  ModifyRouteToIndudeO  method,  and  use  its 
TotalDistanceO  method  to  set  an  integer  variable  called  distance3. 


L 


J 


The  built-in  C#  Math  MinO  method  compares  two  numbers  and  returns  the  smallest 
one  Mike  used  it  to  find  the  shortest  distance  to  the  destination 


int  shortestDistance  =  Math. Min (distancel,  Math. Min (distance2,  distance3) ) ; 


you  are  here  ► 
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static  cling 


r  ^Sharpen  your  pencil 
v  Solution 


Follow  the  same  steps  that  Mike  followed  on  the  facing  page  to  write 
the  code  to  create  Navigator  objects  and  call  their  methods. 


String  destination  =  textBoxl .Text; 

String  route2StreetToAvoid  =  textBox2 .Text; 
String  route3StreetToInclude  =  textBox3 . Text; 

Navigator  navigatorl  =  new  Navigator () 
navigatorl .SetDestination (destination) ; 
int  distancel  =  navigatorl .TotalDistanceO; 


We  gave  you  a  head  start  Here’s 
the  Code  to  jet  the  destination  and 
street  names,  along  with  the  Code  to 
create  the  first  Navigator  object, 
set  its  route,  and  get  the  distance 


r  —  —  —  —  —  —  —  —  —  —  —  —  —  —  —  —  —  -| 

1 .  Create  the  navigator2  object,  set  its  destination,  call  its  ModifyRouteToAvoidO  method,  and  use  its 

TotalDistanceO  method  to  set  an  integer  varable  called  distance2. 

Navigator  navigator2  =  new  NavigatorO 
navigator2 .  SetDestmation(destmation); 
navj_gator2  /V|odifyRouteloAvo(d(route2£treetToAvoid); 

int  distance2  =  navigator 2.. TotalDistanceO; 


2.  Create  the  navigator3  object,  set  its  destination,  call  its  ModifyRouteTolnclude()  method,  and  use  its 
I  TotalDistanceO  method  to  set  an  integer  varable  called  distance3. 

Navigator  navigator^  —  new  NavigatorO 

I  navigator^.SetDestination(destination),  I 

navigator^  ModifyRoute7o|nclude(route3Street7o|nclude);  • 

mt  distanced  —  navigator^  TotalDistanceO; 

The  built-in  C#  /Vlath  NlmO  method  compares  two  numbers  and  returns  the  smallest 
one  Mike  used  it  to  find  the  shortest  distance  to  the  destination 

int  shortestDistance  =  Math. Min (distancel,  Math. Min (distance2,  distance3) ) ; 
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Hold  it!  I've  written  a  few  classes  now,  but  I  haven’t 
used  “new"  to  create  an  instance  yet!  So  does  that 
means  I  can  call  methods  without  creating  objects? 


Yes!  That’s  why  you  used  the  static  keyword  in  your  methods. 

Take  another  look  at  die  declaration  for  the  Talker  class  you  built  a  few  pages  ago: 


class  Talker 
1 

public  static  int  BlahBlahBlah (String  thingToSay,  int  numberOf Times) 

I 

string  finalstring  = 


When  you  called  the  method  you  didn’t  create  a  new  instance  of  Talker.  You  just  did  this: 
Talker. BlahBlahBlah ("Hello  hello  hello",  5) ; 


That’s  how  you  call  static  methods,  and  you’ve  been  doing  that  all  along.  If  you  take  away 
the  static  keyword  from  the  BlahBlahBlah  ( )  method  declaration,  then  you’ll  have  to 
create  an  instance  of  Talkerf)  in  order  to  call  the  method.  Other  than  that  distinction,  static 
methods  are  just  like  object  methods.  You  can  pass  parameters,  they  can  return  values,  and 
they  live  in  classes. 

There’s  one  more  thing  you  can  do  with  the  static  keyword.  You  ran  mark  your  whole 
class  as  static,  and  then  all  of  its  methods  must  be  static  too.  If  you  try  to  add  a  non-static 
method  to  a  static  class,  it  won’t  compile. 


there,  are  no 

Dumb  Questions 


V:  When  I  think  of  something  that's  "static”.  I  think  of 
something  that  doesn't  change.  Does  that  mean  non-static 
methods  can  change,  but  static  methods  don’t?  Do  they 
behave  differently? 

No,  both  static  and  non-static  methods  act  exactly  the 
same.  The  only  difference  is  that  static  methods  don’t  require 
an  instance,  while  non-static  methods  do  A  lot  of  people  have 
trouble  remembering  that,  because  the  word  “static”  isn’t  really 
all  that  intuitive. 

o 

So  I  can  t  use  my  class  until  I  create  an  instance  of 
an  object? 

You  can  use  its  static  methods.  But  if  you  have  methods 
that  aren’t  static,  then  you  need  an  instance  before  you  can 
use  them. 


Oj 

Then  why  would  I  want  a  method  that  needs  an 
instance?  Why  wouldn't  I  make  all  my  methods  static? 

Because  if  you  have  an  object  that's  keeping  track  of 
certain  data— like  Mike's  instances  of  his  Navigator  class  that 
each  kept  track  of  a  different  route— then  you  can  use  each 
instance's  methods  to  work  with  that  data.  So  when  Mike  called 
his  ModifyRouteToAvoid()  method  in  the  navigator2  instance, 
it  only  affected  the  route  that  was  stored  in  that  particular 
instance.  It  didn't  affect  the  navigatorl  or  navigator3  objects. 
That's  how  he  was  able  to  work  with  three  different  routes  at 
the  same  time — and  his  program  could  keep  track  of  all  of  it. 

(  V 

So  how  does  an  instance  keep  track  of  data? 

Turn  the  page  and  find  out! 
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an  object’s  state  of  affairs 


Aw  instance  uses  fields  to  keep  track  of  things 

You  change  the  text  on  a  button  by  setting  its  Text  property  in  the  Technically,  it's  setting  a 

IDE.  When  you  do.  the  IDE  adds  code  like  this  to  the  designer: 

buttonl.Text  =  "Text  for  the  button"; 

Now  you  know  that  buttonl  is  an  instance  of  the  Button  class. 

What  that  code  does  is  modify  a  field  for  the  buttonl  instance. 

You  can  add  fields  to  a  class  diagram — just  draw  a  horizotal  line  in 
the  middle  of  it.  Fields  go  above  the  line,  methods  go  underneath  it. 


special  kind  of  field— but 
we'll  get  into  all  that  a 
little  later  OK 


This  is  where  a  class 
diagram  shows  the  *■" 
fields  Every  instance 
of  the  class  uses 
them  to  keep  track 
o-f  its  state 


Class 


Fieldl 

Field2 

Field3 


Methodic) 

Method2() 

Method3() 


Add  this  line  to 
separate  the  fields 
from  the  methods 


Methods  are  what  an  object  does.  Fields  are  what  the  object  knows. 

When  Mike  created  three  instances  of  Navigator  classes,  his  program  created  three  objects. 

Each  of  those  objects  was  used  to  keep  track  of  a  different  route.  W  hen  the  program  created  the 
navigator2  instance  and  called  its  SetDestination  ()  method,  it  set  the  destination  lor  that 
one  instance.  But  it  didn't  affect  the  navigatorl  instance  or  the  navigator3  instance. 


Navigator 


Destination 

Route 


SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolndude() 

GetRoute() 

GetTimeToDestination() 

TotalDistance() 


Every  instance  of  Navigator  knows 
its  destination  and  its  route- 


tVhat  a  Navigator  object  does  is 
let  you  set  a  destination,  modify 
its  route,  and  get  information 
about  that  route 


An  object's  behavior  is  defined  by  its  methods, 
and  it  uses  fields  to  keep  track  of  its  state. 
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Let's  create  some  instances! 

It’s  easy  to  add  fields  to  your  class. Just  declare 
variables  outside  of  any  methods.  Now  every 
instance  gets  its  own  copy  of  those  variables. 


.*•5"*?'  «ee 

»«  fro*{  of  a  method, 
it  means  that  it  doesn't 
return  any  value 


public  class  Clown  { 
public  String  Name; 
public  int  Height; 

public  void  TalkAboutYourself () 
MessageBox .Show ("My  name  is  " 
+  Name  +  "  and  I'm  " 

+  Height  +  "  inches  tall.") 


Men  you  want  to  Create  instances 
of  your  class,  dojvt^se  the  static 
keyword  in  either  the  class  declaration 
or  the  method  declaration 

,3arpen  your  pencil _ 


Remember,  the  *=  operator  tells  C# 
to  take  whatever's  on  the  le-ft  of  the 
operator  and  multiply  it  by  whatever’s 
on  the  ri^ht 


Write  down  the  contents  of  each  message  box  that  will  be  displayed 
after  the  statement  next  to  it  is  executed. 


Clown  oneClown  =  new  Clown (); 
oneClown .Name  =  "Boffo"; 
oneClown . Height  =  14; 

oneClown .  TalkAboutYourself  ( )  ;  "My  name  is _ and  I'm _ inches  tall." 


Clown  anotherClown  =  new  Clown ( ) ; 
anotherClown.Name  =  "Biff"; 
anotherClown . Height  =  16; 

anotherClown .  TalkAboutYourself  ( )  ;  "My  name  is _ and  I’m _ inches  tall." 

Clown  clown3  =  new  Clown (); 
clown3.Name  =  anotherClown.Name; 
clown3 . Height  =  oneClown. Height  -  3; 

clown3  .TalkAboutYourself  ()  ;  "My  name  is _ and  I'm _ inches  tall." 

anotherClown. Height  *=  2; 

anotherClown .  TalkAboutYourself  ( )  ;  “My  name  is _ and  I’m _ inches  tall.” 
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a  heaping  helping  of  objects 


Thanks  for  the  memory 

When  your  program  creates  an  object,  it  lives  in  a  part  of  the 
computer’s  memory  called  the  heap.  When  your  code  creates  an 
object  with  a  new  statement,  C#  immediately  reserves  space  in  the 
heap  so  it  can  store  the  data  for  that  object. 


Here's  a  picW  the  heap  before  the 
project,  starts  Notice  that  its  empty 


Let's  take  a  closer  look  at  what  happened  here 


Sharpen  your  pencil 
v  Solution 


Clown  oneClown  V  new  Clown  () ; 
oneClown  .Name  =  " BcTf  [ u " ; 
oneClown .Height  =  14; 

oneClown. TalkAboutYourself () ; 

Clown  anotherClown  =^nev^Clown ( ) ; 
anotherClown .Name  =  "bTTF'T 
anotherClown . Height  =  16; 

anotherClown . TalkAboutYourself ( ) ; 


Write  down  the  contents  of  each  message  box  that  will  be  displayed 
after  the  statement  next  to  it  is  executed. 

tSrf  ***  *  “t-.  j  *.  cu. 

"My  name  is  Boffo  and  I’m  ^  inches  tall.” 


"My  name  is  B,fl  .  and  I'm  ^  inches  tall.” 


Clown  clown3  =  \iew  Clown  ( )  ; 
clown 3. Name  =  anotherClown. Name; 
clown3. Height  =  oneClown. Height  -  3; 

clown3 .TalkAboutYourself () ; 

anotherClown . Height  *=  2; 

anotherClown . TalkAboutYourself ( ) ; 


"My  name  is  Biff  and  I'm  N  inches  tall." 


"My  name  is  Biff  and  I’m  inches  tall." 


When  your  program  creates  a  new  object,  it  gets  added  to  the  heap. 
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What's  on  your  program's  wind 

Here’s  how  your  program  creates  a  new  instance  of  the 
Clown  class: 

Clown  mylnstance  =  new  Clown (); 

That’s  actually  two  statements  combined  into  one.  The 
first  statement  declares  a  variable  of  type  Clown  (Clown 
mylnstance;).  The  second  statement  creates  a  new 
object  and  assigns  it  to  the  variable  that  was  just  created 
(mylnstance  =  new  Clown  ();).  Here’s  what  tJje'Heap 
looks  like  after  each  of  these  statements: 


This  object  is  an  hsjji/C  "the 
Clown  class  .  J 

v 


>C/o^do)^ 


is  create  a;° 

?ie\ds  SC 


Clown  oneClown  =  new  Clown () 
oneClown.Name  =  "Boffo"; 
oneClown .Height  =  14; 
meClown .TalkAboutYourself () 


Clown  anotherClown  =  new  Clown ( ) ; 

anotherClown .Name  =  "Biff";  T^ese 

the  second  object 

anotherClown. Height  =  16;  with  data  J 
►anotherClown. TalkAboutYourself () ; 


C/°ivn  60^ 


Woivn  do* 


create 
and  -Pill  it 


Clown  clown3  =  new  Clown (); 
clown3.Name  =  anotherClown. Name; 
clown3 . Height  =  oneClown. Height  -3; 
clown3. TalkAboutYourself () ;  ,  .. 

Th,  #*<>  or.  ^  ‘ 

treated  and  yoyulated 

^  anotherClown. Height  2; 

►anotherClown. TalkAboutYourself () ; 

There’s  no  new  Command,  which  means 
these  statements  don't  Create  a  new 
object  They're  just  modifying  one 
that's  already  in  memory 


cKn  oX>^ 


C/oivn  0X^ 


°^/r\  oX)^ 
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making  methods  make  sense 


You  can  use  class  and  method  names 
to  make  your  code  intuitive 


When  you  put  code  in  a  method,  you’re  making  a  choice  about  how  to  structure 
your  program.  Do  you  use  one  method?  Do  you  splii  it  into  more  than  one?  Or  do 
you  even  need  a  method  at  all?  The  choices  you  make  about  methods  can  make  your 
code  much  more  intuitive — or,  if  you’re  not  careful,  much  more  convoluted. 


Here’s  a  nice,  compact  chunk  of  code.  It’s  from  a  control  program  that 
runs  a  machine  that  makes  candy  bars.  -n 


W  I  .»  H..H  .  J  «  » 

obj  ,  ids  ,  and  n> 
are  -terrible  names^ 
We  have  no  idea  _ 
what  they  da  And 
what’s  that  TO 
dlass  -for? 


int  t  =  m.chkTempO 
if  (t  >  160)  { 

T  obj  =  new 
tb.clsTrpV^) 
ics.Fill () ; 
ics . Vent ( ) ; 

, m.airsyschk () 


S  an 


The  dlsTry\/0 
method  has  one 
parameter,  but  we 
don't  know  what 
it’s  supposed  to  be 


Take  a  second  and  look  at  that  code.  Can  you  figure  out  what  it  does? 


Those  statements  don’t  give  you  any  hints  about  why  the  code’s  doing  what  it’s  doing.  In  this  case,  the 
programmer  was  happy  with  the  results  because  she  was  able  to  get  it  all  into  one  method.  But  making 
your  code  as  compact  as  possible  isn’t  really  useful!  Let’s  break  it  up  into  methods  to  make  it  easier  to 
read,  and  make  sure  the  classes  are  given  names  that  make  sense.  But  we'll  start  by  figuring  out  what  the 
code  is  supposed  to  do. 


Ho.  do  ■,« 

tod*  -  T 

Well,  dll  J  '  I  t, 

r 

» is.  "TiLd. 

tka  tee  roy*"*"' Wlw' 


General  Electronics  Type  5  Candy  Bar  Maker 
Specification  Manual 

The  nougat  temperature  must  be  checked  every  3  minutes  by  an 
automated  system.  If  the  temperature  exceeds  160°C,  the  candy 
is  too  hot,  and  the  system  must  perform  the  candy  isolation 
cooling  system  (CICS)  vent  procedure. 

•  Close  the  trip  throttle  valve  on  turbine  #2 

•  Fill  the  isolation  cooling  system  with  a  solid  stream  ol  water 

•  Vent  the  water 

•  Verify  that  there  is  no  evidence  of  air  in  the  system 
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That  page  from  the  manual  made  it  a  lot  easier  to  understand  the  rode.  It  also  gave  us  some  great 
hints  about  how  to  make  our  code  easier  to  understand.  Now  we  know  why  the  conditional  test  checks 
the  variable  t  against  160 — the  manual  says  that  any  temperature  above  160°C  means  the  nougat  is 
loo  hot.  And  it  turns  mil  that  “in'  was  a  class  that  controlled  the  candy  maker,  with  static  methods 
to  check  the  nougat  temperature  and  check  the  air  system.  So  let's  put  the  temperature  check  into  a 
method,  and  choose  names  for  the  class  and  the  methods  that  make  the  purpose  obvious. 


The  UNa^ToolUO 

method’s  return  ty?e 


public(boolean\IsNouqatTooHot ()  { 

int  temp  =  Maker. CheckNougatTemperature () ; 

if  (temp  >  160)  {  ^  By  naming  the  eUss  "Maker’’  and  the 

return  true;  method  "ChetkNou^atTemperature  , 

}  else  {  ^  tode  is  a  lot  easier  to  understand 

return  false; 


This  method’s  return  tyye  is  boolean, 
which  means  it  returns  a  true  or 


false  value 


What  does  the  specification  say  to  do  if  the  nougat  is  too  hot?  It  tells  us  to  perform  the  candy  isolation 
cooling  system  (or  GIGS)  vent  procedure.  So  let's  make  another  method,  and  choose  an  obvious 
name  for  the  “T"  class  (which  turns  out  to  control  the  turbine)  and  the  “ics”  class  (which  controls  the 
isolation  cooling  system,  and  has  two  static  methods  to  fill  and  vent  the  system): 


public  vyoidjDoCICSVentProcedure  ()  { 

A  void  rein*-*  ^  Turbine  turbineController  =  new  Turbine  (); 

■the  method  doesn’t  turbineController  .CloseTripValve  (2)  ; 

return  any  value  at  all.  IsolationCoolingSystem. Fill  ()  ; 

IsolationCoolingSystem. Vent () ; 

Maker .CheckAirSystem ( ) ; 


1 

Now  die  code's  a  lot  more  intuitive!  Even  if  you  don’t  know  that  the  GIGS  vent  procedure  needs  to 

be  run  if  the  nougat  is  too  hot,  it’s  a  lot  more  obvious  what  this  code  is  doing: 


if  (IsNougatTooHot ()  ==  true)  { 
DoCICSVentProcedure ()  ; 

1 


You  can  make  your  code  easier  to  read  and  write  by  thinking  about 
the  problem  your  code  was  built  to  solve.  If  you  choose  names  for  your 
methods  that  make  sense  to  someone  who  understands  that  problem, 
then  your  code  will  be  a  lot  easier  to  deciphetv.and  develop! 
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classes  au  naturale 


(rive  your  classes  a  natural  structure 


Take  a  second  and  remind  yourself  why  you  want  to  make  your  methods  intuitive: 
because  every  program  solves  a  problem  or  has  a  purpose.  It  might  not 
be  a  business  problem — sometimes  a  program’s  purpose  (like  Flashy Tiling)  is  just  to 
lie  cool  or  fun!  But  no  matter  what  your  program  does,  the  more  you  can  make  your 
code  resemble  the  problem  you're  trying  to  solve,  the  easier  your  program  will  be  to 
write  (and  read,  and  repair,  and  maintain...).  _ 


Use  class  diagrams  b>  yla*  y°ur  classes 

A  class  diagram  is  a  simple  way  draw  your  [ciassNam^_ 

classes  out  ok  ?ayev.  It's  a  really  valuable  tool  [MethodO 

.for  des.3K.n5  your  Code  B&FORfc  ^  start  I 

wrrti*5  it 


C 

Write  the  name  of  the  class  at  the  top  of 
the  diagram.  Then  write  each  method  in  the 
bo*  at  the  bottom.  Now  you  can  see  all  o*  t  e 
yarts  of  the  class  at  a  glance! 


Let  $  build  a  class  diagram 

Take  another  look  at  the  if  statement  in  #5  on  the  last  page.  You  already  know  that  statements 
always  live  inside  methods,  which  always  live  inside  classes,  right?  In  this  case,  that  if  statement  was 
in  a  method  called  DoMaintenanceTests  ( ) ,  which  is  part  of  the  CandyController  class. 
Now  take  a  look  at  the  code  and  the  class  diagram.  See  how  they  relate  to  each  other? 


public  class  CandyController  { 

public  void  DoMaintenanceTests ( )  { 

if  (IsNougatTooHot ( )  ==  true)  { 
DoCICSVentProcedure ()  ; 

} 

1 

public  void  DoCICSVentProcedure ()  ... 

public  boolean  IsNougatTooHot ()  ... 


CandyController 

DoMaintenanceTests() 

DoCICSVentProcedure() 

lsNougatTooHot() 
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The  code  for  the  candy  control  system  we  built  on  the  previous 
page  called  three  other  classes.  Flip  back  and  look  through  the 
code,  and  fill  in  their  class  diagrams. 


Theire  was  or*  other 
class  m  the  code  on  the 
Previous  page.  Fill  in  its 
and  method 
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a  few  helpful  tips 


Class  diagrams  help  you  organize  your  classes 
so  they  make  sense 

Writing  out  class  diagrams  makes  it  a  lot  easier  to  spot  potential  problems  in  your 
classes  before  you  write  code.  Thinking  about  your  classes  from  a  high  level  before 
you  get  into  the  details  can  help  you  come  up  with  a  class  structure  that  will  make 
sure  your  code  addresses  the  problems  it  solves.  It  lets  you  step  back  .and  make  sure 
that  you’re  not  planning  on  writing  unnecessary  or  poorly  structured  classes  or 
methods,  and  that  the  ones  you  do  write  will  lx-  intuitive  and  easy  to  use. 


Dishwasher 

The  class  is  called 
“Dishwasher”,  so  all  the 
methods  should  be  about 
washing  dishes.  But  one 
method — ParkTheCar() — has 
nothing  to  do  with  dishes,  so  it 
should  be  taken  out  and  put  in 
another  class. 

Dishwasher 

CleanDishes() 

AddDetergent() 

SetWaterTemperature() 

ParkTheCarQ 

CleanDishes() 

AddDetergent() 

SetWaterTemperalure() 

The  code  for  the  candy  control  system  we  built  on  the  £«»  d  igure  out  that 
previous  page  called  three  other  classes.  Flip  back  and  Wakcr  is  a  class  bedaus*  it 
look  through  the  code,  and  fill  in  their  class  diagrams.  in  -front  of  a  dot  in 

/WakerCheckAirSystemO. 


Turbine 

I  sol  aii  or\C  ool  i  rv^Sys-tem 

Maker  ^  1 

Fill() 

CloscTnf\/alvcO 

CkedkNou^aiTempera'tureO  1 

\/e»vt0 

CkedkAirSystemO 
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Each  of  these  classes  has  a  serious  design  flaw.  Write  down  what 
you  think  is  wrong  with  each  class,  and  how  you'd  fix  it. 


Class23 

CandyBarWeight() 

PrintWrapper() 

GenerateReport() 

Go() 


This  class  is  part  of  the  candy  manufacturing  system  from  earlier. 


DeliveryGuy 

AddAPizza() 

PizzaDeliveredQ 

TotalCash() 

ReturnTime() 

DeliveryGirl 

AddAPIzza() 

PizzaDelivered() 

TotalCash() 

ReturnTime() 

These  two  classes  are  part  of  a  system  that  a  pizza  parlor  uses  to 
track  the  pizzas  that  are  out  for  delivery. 


- — - — — - — -  The  CashRegister  class  is  part  of  a  program  that's  used  by  an 

UasnKegiSter  automated  convenience  store  checkout  system. 

MakeSaleQ 

NoSale()  . 

PumpGasO 

Refund()  . 

TotalCashlnRegister() 

GetTransactionList()  . 

AddCash() 

RemoveCashQ  . 
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create  a  class 


irpen  your  pencil _ 

'  ^nlilfinn  Here’s  how  we  corrected  the  classes.  They’re  just  one 
UwlUWUll  possible  way  to  fix  the  problems — but  there  are  plenty  of  other  ways 


you  could  design  these  classes  depending  on  how  they'll  be  used. ' 


This  class  is  part  of  the  candy  manufacturing  system  from  earlier. 

The  class  name  doesn  't  describe  what  the  class  does.  A  programmer 
who  sees  a  line  of  Code  that  calls  Class2.3tjoO  will  have  no  idea  what 
that  line  does  We'd  also  rename  the  method  to  something  that's  more 
descriptive— we  chose  /VJakeTheCandyO,  but  it  could  be  anything 


ClassMaker 

CandyBarWeightQ 

PrintWrapperQ 

GenerateReportQ 

MakeTheCandyO 


These  two  classes  are  part  of  a  system  that  a  pizza  parlor  uses  to 
track  the  pizzas  that  are  out  for  delivery. 

It  looks  like  the  Delivery^uy  class  and  the  Deliverydjirl  class 

both  do  the  same  thing— -they  track  a  delivery  person  who's  out 

delivering  pizzas  to  Customers  A  better  design  would  replace 

them  with  a  single  class  that  adds  a  f  ield  for  gender.. 


DeliveryPerson 

Gender 

AddAPizza() 

PizzaDeliveredQ 

TotalCash() 

ReturnTime() 


We  added  the  Render  field  because  we 
assumed  there  was  a  reason  to  track  both  , 
delivery  guys  and  g.rls  separately,  and  that** 
why  there  were  two  classes  tor  them- 


The  CashRegister  class  is  part  of  a  program  that's  used  by  an 
automated  convenience  store  checkout  system. 

AH  of  the  methods  in  the  class  do  stuff  that  has  to  do  with 


a  cash  register— making  a  sale,  getting  a  list  of  transactions, 
adding  cash  except  for  one:  pumping  gas  It's  a  good  idea  to 


pull  that  method  out  and  stick  it  in  another  class 


CashRegister 

MakeSale() 

NoSale() 

Refund!) 

TotalCashlnRegisterQ 

GetTransactionList() 

AddCashQ 

RemoveCashQ 
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public  partial  class  Forml  :  Form 

{ 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


String  result  = 

Echo  el  =  new  Echo(); 

int  x  =  0; 

while  (  _  )  { 

result  =  result  +  el. hello ()  +  ”\n"; 


Your  job  is  to  take  code  snippets  from  the 
pool  and  place  them  into  the  blank 
lines  in  the  code.  You  may  use 
■■  the  same  snippet  more  than  once, 
and  you  won't  need  to  use  all  the 
2/  snippets.  Your  goal  is  to  make 
r  classes  that  will  compile  and  run 
and  produce  the  output  listed. 


if  ( 


)  ( 


e2. count  =  e2. count  +  1; 

) 

if  (  _  )  { 

e2. count  =  e2. count  +  el. count; 

) 

x  =  x  +  1; 

} 

MessageBox. Show (result  +  "Count:  "  +  e2. count); 

) 

public  class  _  { 

public  int  _  =  0; 


Output 


Bonus  Question! 


public  string  _  { 

return  "helloooo. . . 

) 

) 

) 


If  the  last  line  of  output  was 
24  instead  of  10  how  would 
you  complete  the  puzzle  ? 
You  can  do  it  by  changing 
just  one  statement. 


working  class  guys 


Puild  a  class  to  work  with  sowe  guys 


Joe  and  Boh  lend  each  other  money  all  the 
time.  Let's  build  a  class  to  keep  track  of  them. 


We’ll  create  a  Guy  class  and  add  two  instances  of  it  to  a  form 

The  form  will  have  two  fields,  one  called  j  oe  (to  keep  track  of  the  first  object), 
and  the  other  called  bob  (to  keep  track  of  the  second  object). 


The  new  statements 
that  create  the  two 
instances  lives  in  the 
Code  that  yts  run  as 
soon  as  the  form  is 
treated  Here’s  what 
the  heap  looks  like 
after  the  form  is 
loaded 


Guy 


Name 

Cash 


GiveCash() 

TakeCash() 


We’ll  set  each  Guy  object's  cash  and  name 

The  two  objects  represent  different  guys,  so  each  one  has  its  own  name 
and  a  different  amount  of  cash  in  his  pocket. 


Each  guy  has  a  Name 
■field  that  keeps  brack  of 
his  na**«e,  and  a  Cash  field 
that  has  the  number  of 
bucks  in  his  podket- 


We'll  give  cash  to  the  guys  and  take  cash  from  them 

We’ll  use  each  guy’s  GiveCash  ( )  method  to  give  cash  to  a  guy,  and 
we’ll  use  his  TakeCash  ( )  method  to  take  cash  back  from  him. 

The  form  calls  the  objects 


When  you  take  an 
instance  of  £juy  and 
call  its  TakeCashO 
method,  you  pass  the 
amount  of  cash  to  take 
as  a  parameter  So 
calling  joeTakeCash(2-5) 
takes  Z*5  bucks  fr  Or* 
Joe 


Joe . TakeCash (25) ; 

(  ^  ) 

1  100  1  - 

l  75  1 

The  method  returns  the 
number  of  bucks  that 
were  taken. 


0b'\p^ 
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Create  a  project  for  your  guys 

Create  a  new  Windows  Forms  Application  project  (because 
we’ll  be  using  a  form).  Then  use  the  Solution  Explorer  to  add  a 
new  class  to  it  called  Guy.  Make  sure  to  add  “using  System. 
Windows  .  Forms;  ”  to  the  lop  of  the  Guy  class  file.  Then  fill 
in  the  Guv  class.  Here’s  the  code  for  it: 


♦ 

Do  tliis! 


* 


4 


public  class  Guy  { 

public  string  Name; 
public  int  Cash; 


} 


public 
77  if 

The  6juy  makes  /  * 
sure  -that  you're 
asking  him  -for  a 
positive  amount 
©f  cash,  otherwise 
he'd  add  to  his 
cash  instead  ot 
taking  away  from 
it 

> 


The  ^uy  class  has  two  fields  The  Name  field  is 
a  string  and  it'll  Contain  the  guy's  name  ("Joe"). 

And  the  Cash  field  is  an  int»  whidh  will  keep 
^ra£k  of  how  many  budks  are  in  his  podket 

The  SiveCashO  method  has  one  parameter 
dalled  amount  that  you  II  use  to  tell  the 
Kow  mudh  dash  to  give  you. 

\ 


int  GiveCash(int  amount)  { 
(amount  <=  Cash  &&  amount  >0)  { 

Cash  -=  amount; 
return  amount; 
else  { 

MessageBox . Show ( 

"I  don't  have  enough  cash  to 
Name  +  "  says. . ; 
return  0 ; 


fie  uses  an  if  statement  to  dhedk 
whether  he  has  enough  dash-if  he 
does,  he  takes  it  out  of  his  podket  and 
returns  it  as  the  return  value 


give  you  "  +  amount, 


} 


If  the  guy  doesn't  have  enough  dash,  he'll 
tell  you  SO  With  a  message  box,  and  then 
he'll  make  djiveCashO  return  0 


The  RedeiveCashO  method  works  just  like 

public  int  ReceiveCash  (int  amount)  {  £jweCashO  method  It’s  passed  an 

if  (amount  >0)  {  . _ ,  amount  as  a  parameter,  dhedks  to  make 

Cash  +=  amount;  '  SUre  that  amount  is  greater  than  ter©, 

return  amount ;  and  then  adds  it  to  his  dash 

}  else  { 

MessageBox . Show (amount  +  "  isn't  an  amount  I'll  take" 


Name 

return  0 ; 


says . . . ") 


Be  dareful  with  your  durfy  bradkets.  It's  easy  to 
have  the  wrong  number-make  sure  that  every  opening 
bradket  has  a  matdhmg  dlosing  bradket  H/hen  theyW 
all  balanded,  the  IDE  will  automatidally  indent  them 
for  y<*  wken  you  type  the  last  dlosing  bradket 


if  'the  amount  was  positive,  then  the 
RedeiveCashO  method  returns  the  amount 
added  If  it  was  tero  or  negative,  the  guy 
shows  a  message  box  and  then  returns  0. 
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joe  says,  “ where’s  my  money?" 


Build  a  form  to  interact  with  the  guys 

The  Guy  class  is  great,  hut  it’s  just  a  start.  Now  put  together 
a  form  that  uses  two  instances  of  the  Guy  class.  It’s  got  labels 
that  show  you  their  names  and  how  much  cash  they  have,  and 
buttons  to  give  and  take  cash  from  them. 


Build  this! 
r  *  4 


Add  two  buttons  and  six  labels  to  your  form 

I'lie  labels  on  the  right-hand  side  of  the  form  show  how  much  cash  each  guy  has.  We’ll  also 
add  a  variable  called  bank  to  the  form — the  third  label  on  the  right  shows  how  much  cash  is  in 
it.  We’re  going  to  have  you  name  some  of  the  labels  that  you  drag  onto  the  forms.  You  can  do 
that  by  clicking  on  each  label  that  you  want  to  name  and  changing  its  “(Name)”  row  in 
the  Properties  window.  That'll  make  your  code  a  lot  easier  to  read,  because  you’ll  be  able  to  use 
“joesCash”  and  “bobsCash"  instead  of  "label 4"  and  “labe!5”. 


m 


Fun  with  Joe  and  Bob 


Joe  has  $50 
Bob  has  $100 
The  bank  has  $100 


This  button  will  tall  the  Joe 
object's  ReCeiveCashO  method, 
passing  it  10  as  the  amount,  and 
subtracting  the  cash  it  gives  to 
Joe  fr  o»  the  bank  variable. 


Give  $10  to 

Receive  $5 

Joe 

from  Bob 

tome  the  top  label  joesCash, 
the  label  underneath  it 
^bobsCash,  and  the  bottom 
label  bankCash.  you  can  leave 
their  Text  properties  alone, 
we  II  add  a  method  to  the 
■form  to  set  them 


This  button  will  Call  the  Bob 
object's  ^iveCashO  method, 
passing  it  5  as  the  amount,  and 
adding  the  cash  it  receives 
from  Joe  to  the  bank  variable 


Add  variables  to  your  form 

Your  form  will  need  to  keep  track  of  the  two  guys,  so  you'll  need  a  variable  for  each  of  them.  Call 
them  joe  and  bob.  Then  add  a  variable  to  the  form  called  bank  to  keep  track  of  how  much 
money  the  form  has  to  give  to  and  receive  from  the  guys. 


namespace  Your_Pro j ect_Name  { 
SinCe  we  re  using  public  partial  class  Forml 

£juy  objects  to 

keep  track  of  Guy  joe; 

Joe  and  Bob, 
you  declare 
their  variables 


Form  { 


Guy  bob; 
int  bank 


100 


,  4C 


using  Guy 


public  Forml <)  { 

InitializeComponent () ; 

} 


The  amount  of  cash  in 
the  bank  goes  up  and 
down  depending  on  how 
much  money  the  form 

Jave  to  and  received 
com  the  djuy  objects. 
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©  Add  a  method  to  the  form  to  update  the  labels 

The  labels  on  the  right-hand  side  of  the  form  show  how  much  cash  each  guy  has  and  how  much 

is  in  the  bank  variable.  So  add  the  UpdateForm  ( )  method  to  keep  them  up  to  date  make 

sure  the  return  type  is  void  to  tell  G#  that  the  method  doesn't  return  a  value.  Type  this 

method  into  the  form  right  underneath  where  vou  added  the  bank  variable:  -r-,  ,  , 

I  his  new  method  is  simple 

public  void  UpdateForm ()  { 

Notice  how  the  labels  c"  joesCash.Text  =  joe. Name  +  "  has  $"  +  joe. Cash; 

/  bobsCash.Text  =  bob. Name  + 


has  $"  +  bob. Cash; 


are  updated  using  the 

objects’  Name  and  bankCash.Text  =  "The  bank  has  $"  +  bank; 

Cash  fields.  j 


It  just  updates  the  three 
labels  by  setting  their  Text 
properties  You’ll  have  each 
button  call  it  to  keep  the 
labels  up  to  date 


Double-click  on  each  button  and  add  the  code  to  interact  with  the  objects 

Make  sure  the  left-hand  button  is  called  button  1,  and  the  right-hand  button  is  called  button2. 
Then  double-click  each  of  the  buttons — when  you  do,  the  IDE  will  add  two  methods  called 
buttonl  Click  ( )  and  button2_Click  ( )  to  the  form.  Add  this  code  to  each  of  them: 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 

if  (bank  >=  10)  {  ^  WVn  the  user  clicks  the  u$ive  j\0  to 

bank  -=  joe.ReceiveCash  (10) ;  >  button,  the  form  calls  the  Joe 
UpdateForm ( ) ;  \  objc^’s  ReCe.veCashO  method-but  only 

)  else  (  *  bah^  bas  er,0',gb  money. 

MessageBox. Show ("The  bank  is  out  of  money."); 

\The  bark  needs  at  least  jlO  to  give  to 
Joe  if  there’s  not  enough,  it’ll  pop  up 
this  message  box 

private  void  button2_Click (object  sender,  EventArgs  e)  { 
bank  +=  bob.GiveCash (5) ; 

UpdateForm  () ;  /N  The  “Receive  from  Bob  button 

,  doesn’t  reed  to  check  how  much  is 

the  bark,  because  it’ll  just  add 


in  xnc  Odnr,  -  f 

whatever  Bob  gives  back  'f  S  ^  ~  T* 

^iveCashO  will  return  zero- 


Q  Start  Joe  out  with  $50  and  start  Bob  out  with  $100 

It's  up  to  you  to  figure  out  how  to  get  Joe  and  Bob  to  start  out  with  their  Gash  and 
Name  fields  set  properly.  Put  it  right  underneath  InitializeComponent  ()  in  the  form. 
That's  part  of  a  special  method  that  gets  run  once,  when  the  form  is  first  initialized. Once  you've 
done  that,  click  both  buttons  a  number  of  times  -make  sure  that  one  button  takes  $10  from  the 
bank  and  adds  it  to  Joe,  and  the  other  takes  $5  from  Bob  and  adds  it  to  the  bank. 


ExenciSe 


public  Form()  { 

InitializeComponent ( ) ;  kr 

//  Initialize  joe  and  bob  here! 

} 


Add  -the  tires  of  code  here  to 
Create  the  two  objects  ard  set 
their  Name  ard  Cash  fields. 
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RCl$€ 

IvtlOM 


It's  up  to  you  to  figure  out  how  to  get  Joe  and  Bob  to  start  out  with  their  Cash 
and  Name  fields  set  properly.  Put  it  right  underneath  InitializeComponent  () 

public  Forml  ()  { 

InitializeComponent ( ) ; 


Then  we  do  ike  same  for  the 
second  instance  of  the  6juy  class. 


there  |  ore  n<? 

Dumb  Questions 


Make  sure 

protect  now-we’H  to~t 

back  to  it  ir  a  few  ?a$es 


;  Why  doesn't  the  solution  start  with  “Guy  bob  =  new 
Guy  ( )  ”?  Why  did  you  leave  off  the  first  “Guy”? 

Because  you  already  declared  the  bob  variable  at  the  top  of 
the  form.  Remember  how  the  statement  “int  i  =  5;  "is  the 
same  as  the  two  statements  “int  i”and"i  =  5 ;"?  This  is  the 
same  thing  You  could  try  to  declare  the  bob  variable  in  one  line  like 
this:  “Guy  bob  =  new  Guy  ( )  ; But  you  already  have  the 
first  part  of  that  statement  (“Guy  bob ;  “)  at  the  top  of  your  form. 
So  you  only  need  the  second  half  of  the  line,  the  part  that  sets  the 
bob  variable  to  create  a  new  instance  of  Guy  ( ) . 


Qj  What  happens  if  I  don’t  leave  off  that  first  “Guy”? 

You'll  run  into  problems— your  form  won't  work,  because  it 
won’t  ever  set  the  form's  bob  variable.  Think  about  it  for  a  minute, 
and  you’ll  see  why  it  works  that  way  If  you  have  this  code  at  the  top 
of  your  form: 

public  partial  class  Forml  :  Form  { 
Guy  bob; 

and  then  you  have  this  code  later  on,  inside  a  method: 


Qj  Okay,  so  then  why  not  get  rid  of  the  “Guy  bob ; "  line  at 
the  top  of  the  form? 

A. 

•ri*  Then  the  bob  variable  will  only  exist  inside  that  special 
‘public  Forml  ( )  ”  method.  When  you  declare  a  variable 
inside  a  method,  it's  only  valid  inside  the  method— you  can  t  access 
it  from  any  other  method.  But  when  you  declare  it  outside  of  your 
method  but  inside  the  form  or  a  class  that  you  added,  then  you  can 
access  it  from  any  other  method  inside  the  form  or  class. 


Guy  bob  =  new  Guy(); 

then  you've  declared  two  variables.  It's  a  little  confusing,  because 
they  both  have  the  same  name.  But  one  of  them  is  valid  throughout 
the  entire  form,  and  the  other  one— the  new  one  you  added— is  only 
valid  inside  the  method.  The  next  line  (bob .  Name  =  "Bob" ; ) 
only  updates  that  local  variable,  and  doesn’t  touch  the  one  in  the 
form.  So  when  you  try  to  run  your  code,  it'll  give  you  a  nasty  error 
message  (“NullReferenceException  not  handled”),  which  just  means 
you  tned  to  use  an  object  before  you  created  it  with  new. 
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There's  aw  even  easier  way  to  initialize  objects 


Almost  every  object  that  you  create  needs  to  he  initialized  in  some  way. 
And  the  Guy  object  is  no  exception — it’s  useless  until  you  set  its  Name 
and  Cash  fields.  It’s  so  common  to  have  to  initialize  fields  that  G#  gives 
you  a  shortcut  for  doing  it  called  an  object  initializer.  And  the  IDE  s 
IntelliSense  will  help  you  do  it. 


Here’s  the  original  code  that  you  wrote  to 
initialize  Joe’s  Guy  object. 

joe  =  new  Guy(); 
joe. Name  =  "Joe"; 
joe. Cash  =  50; 


Watch  it! 


Object 

initializers  only 
work  with  C# 
3.0. 


If  you’re  running 
Visual  Studio  2005.  then  this 
won't  work.  Definitely  consider 
downloading  Visual  Studio  2008 
Express  Edition — it’s  free,  and 
you  can  install  it  alongside  your 
existing  VS2005  installation. 


Delete  the  second  two  lines,  and  the  semicolon  after  “‘Guy  ( )  ”  and  add  a  right  curly  bracket. 

joe  =  new  Guy()  { 


O 

O 

o 

o 


Press  space.  As  soon  as  you  do,  the  IDE  pops  up  an  IntelliSense  window'  that  shows  you  all  of 
the  fields  that  you’re  able  to  initialize. 

joe  =  new  Guy()  { 


# 

int  Guy.Cash 

* 

Name 

Press  tab  to  tell  it  to  add  the  Gash  field.  Then  set  it  equal  to  50. 

joe  =  new  Guy()  {  Cash  =  50 


Type  in  a  comma.  As  soon  as  you  do,  the  other  field  shows  up. 

joe  =  new  Guy()  {  Cash  =  50, 


Name 


[strng  Guy, Name 


Finish  the  object  initializer.  Now'  you’ve  saved  yourself  two  lines  of  code! 

joe  =  new  Guy()  {  Cash  =  50,  Name  =  "Joe"  }; 

This  new  declaration  does  e*attly  the  same 
thins  as  the  three  lines  of  tode  you  wrote 
originally  It's  just  shorter  and  easier  to  read 


Object 
intializers 
save  you  time 
and  make 
your  code 
more  compact 
and  easier  to 
read...  and  the 
IDE  kelps  you 
write  tkem. 
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A  few  ideas  for  designing  intuitive  classes 


»  You're  building  your  program  to  solve  a  problem. 

Spend  some  time  thinking  about  that  problem.  Does  it  break  down  into  pieces 
easily?  How  would  you  explain  that  problem  to  someone  else?  These  are  good 
things  to  think  about  when  designing  your  classes. 


»  What  real-world  things  will  your  program  use? 

A  program  to  help  a  zoo  keeper  track  her  animals'  feeding  schedules  might  have 
classes  for  different  kinds  of  food  and  types  of  animals. 

ROAD  CLOSED 
CHEMIN  FERME 


* 


» 


Use  descriptive  names  for  classes  and  methods. 


Someone  should  be  able  to  figure  out  what  your  classes 
looking  at  their  names. 


and 


methods  do  just  by 


Look  for  similarities  between  classes. 

Sometimes  two  classes  can  be  combined  into  one  if  they're  really  similar. The  candy 
manufacturing  system  might  have  three  or  four  turbines,  but  there's  only  one 
method  for  closing  the  trip  valve  that  takes  the  turbine  number  as  a  parameter. 


BlockedRoad  i 

Name 

Duration 

ClosedRoad 

StreetName 

ReasonltsClosed 

FindDetour() 

CalculateDelayO 

Detour 

Name 

Duration 

ReasonltsClosed 


FindDetour() 

CalculateDelay() 
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Add  buttons  to  the  “Fun  with  Joe  and  Bob”  program  to  make  the  guys  give  each  other  cash. 


E*eRctSe 


Use  an  object  initializer  to  initialize  Bob's  instance  of  Guy 

You’ve  already  done  it  with  Joe.  Now  make  Bob's  instance  work  with  an  object 

initializer  too.  |£  ^  a|rta(jy  tlicked  ike  button,  just  delete 

it,  add  it  back  to  you*-  £<*•>*»  and  rename  it 

Then  delete  the  old  button^ _ Click 0  method 

that  the  IDE  added  before,  and  use  the  new 

Add  two  more  buttons  to  your  form  method  it  adds  no* 

I  he  first  button  tells  Joe  to  give  10  bucks  to  Bob,  and  the  second  tells  Bob  to  give  5 
bucks  back  to  Joe.  Before  you  double-click  on  the  button,  go  to  the  Properties 
window  and  change  each  button’s  name  using  the  “(Name)”  row — it's  at  the  top  of 
the  list  of  properties.  Name  the  first  button  joeGivesToBob.  and  the  second  one 

bobGivesToJoe 


Fun  with  Joe  and  Bob 


joesCash 

bobsCash 

bankCesh 


This  button  tells  Joe  to 
aive  10  bucks  to  Bob,  so 
you  should  use  the  "(Name) 
row  in  the  Properties 
window  to  name  it 
joeGivesToBob 


Give  $  1 0  to 
Joe 


Receive  $5 
from  Bob 


Joe  gives 
$10  to  Bob 


Bob  gives 
$5  to  Joe 


This  button  tells  Bob  to 
5-re  t  bucks  to  Joe.  Name 
it  bobGivesToJoe 


Make  the  buttons  work 

Double-click  on  the  joeGivesToBob  button  in  the  designer.  The  IDE  will  add  a 
method  to  the  form  called  joeGivesToBobClick  ()  that  gets  run  any  time  the 
button’s  clicked.  Fill  in  that  method  to  make  Joe  give  10  bucks  to  Bob.  Then  double¬ 
click  on  the  other  button  and  fill  in  the  new  bobGivesToJoe  Click  ( )  method 
that  the  IDE  creates  so  that  Boh  gives  five  bucks  to  Joe.  Make  sure  the  form  updates 
itself  after  the  cash  changes  hands. 
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exercise  solution 


Add  buttons  to  the  Tun  with  Joe  and  Bob'  program  to  make  the  guys  give  each  other  cash. 


Excise 
Solution 


public  partial  class  Forml 
Guy  joe; 

Guy  bob; 

int  bank  =  100; 


Form  { 


Here  are  the  object  initializers  (or 
the  two  instances  ©£  the  £juy  class 
Bob  jets  initialized  with  1 00  bucks 
and  his  name- 


public  Forml ()  { 

lr.it  ializeComponont  ()  ; 

bob  =  new  Guy()  {  Cash  =  100,  Name  =  "Bob"  }; 
joe  =  new  Guy()  {  Cash  =  50,  Name  =  "Joe"  }; 

UpdateForm () ; 


The  trick  here  is 
thinking  through 
who’s  giving  the 
Cash  and  who’s f 
receiving  it 


public  void  UpdateForm ()  { 

joesCash.Text  =  joe. Name  +  "  has  $"  +  joe. Cash; 

bobsCash.Text  =  bob. Name  +  "  has  $"  +  bob. Cash;  m^e  Joe  give  cash 

bankCash.Text  =  "The  bank  has  $"  +  bank;  Bob,  we  call  Joe’s 

}  ^iveCashO  method  and 

send  its  results  into 

private  void  buttonl_Click (object  sender,  EventArgs  e)  {  Bob’s  RecetveCashO 
if  (bank  >=  10)  (  method  I 

bank  -=  joe.ReceiveCash (10) ; 

UpdateForm  () ; 

j  0^gg  |  ^ 

MessageBox. Show ("The  bank  is  out  of  money.");  *  e  3  £lose  look  at 
j  ho*  the  quy  methods 

I  are  being  called  The 

results  returned 

private  void  button2_Click (object  sender,  EventArgs  e)  {  by  ^iveCashO  are 
bank  +=  bob.GiveCash  (5) ;  Pimped  right  into 

UpdateForm  ( ) ;  ReCeiveCashO  as  its 

parameter  \ 


private  void  joeGivesToBob_Click.  (object  sender,  EventArgs  e)  { 

bob.ReceiveCash(  joe .GiveCash (10) )  - - - 

UpdateForm ( )  ;  ■ 

> 

private  void  bobGivesToJoe_Click (object  sender,  EventArgs  e)  { 
joe . ReceiveCash (bob . GiveCash (5) ) ; 

UpdateForm () ; 

) 
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Objectcross 

It’s  time  to  give  your  left  brain  a  break,  and  put  that 
right  brain  to  work:  all  the  words  are  object-related 
and  from  this  chapter. 


Across 

2.  If  a  method's  return  type  is _ it  doesn't  return  anything 

7.  An  object's  fields  define  its _ 

9.  A  good  method _ makes  it  dear  what  the  method 

does 

10.  Where  objects  live 

11.  What  you  use  to  build  an  object 

13.  What  you  use  to  pass  information  into  a  method 

14.  The  statement  you  use  to  create  an  object 

15.  A  special  kind  of  field  that's  used  by  the  form  controls 


Down 

1 .  This  form  control  lets  the  user  choose  a  number  from  a  range 
you  set 

3.  It's  a  great  idea  to  create  a  class _ on  paper  before 

you  start  writing  code 

4.  What  an  object  uses  to  keep  track  of  what  it  knows 

5.  These  define  what  an  object  does 

6.  An  object’s  methods  define  its _ 

7  Don't  use  this  keyword  in  your  dass  declaration  if  you  want  to 
be  able  to  create  instances  of  it 

8.  An  object  is  an _ of  a  class 

12.  This  statement  tells  a  method  to  immediately  exit,  and 
specifies  the  value  that  should  be  passed  back  to  the  statement 
that  called  the  method 
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puzzle  solutions 


poo]  Plizz] C  ^o]u£]ol1 

Your  job  was  to  take  code  snippets  from 
the  pool  and  place  them  into  the 
blank  lines  in  the  code. Your  goal 
was  to  make  classes  that  will 
compile  and  run  and  produce  the 
output  listed. 


public  partial  class  Forml  :  Form 
{ 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


{ 

String  result  = 

That's  the  correct  answer 

Echo  el  =  new  Echo();  — 

And  here’s  the  bonus  answer! 

Echo  eZ  —  new  Echof );  ^  _ 

Echo  eZ  =■  el; 

int  x  =  0; 

while  (  %  <  )  { 

result  =  result  +  el. hello ()  +  "\n"; 

elcount  —  clcount  I; _ 

if  (  »  3  )  { 

e2. count  =  e2. count  +1; 

} 

if  (  x  >  0  )  < 

e2. count  =  e2. count  +  el. count; 

} 

x  =  x  +  1; 

» 

MessageBox. Show (result  +  "Count:  "  +  e2. count); 

> 

public  class  Efcho _  ( 

public  int  Count  =0; 

public  string  hellof  )  ( 

return  "helloooo. . . 

) 

} 

> 
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Objectcross  Solution 
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4  Types  and  References 

It’s  10:00.  + 

*  Do  you  know  where  your  data  is?  ^ 


Data  type,  database,  Lieutenant  Commander  Data... 
it’s  all  important  stuff.  Without  data,  your  programs  are  useless.  You 
need  information  from  your  users,  and  you  use  that  to  look  up  or  produce  new 
information,  to  give  back  to  them.  In  fact,  almost  everything  you  do  in  programming 
involves  working  with  data  in  one  way  or  another  In  this  chapter,  you'll  learn  the 
ins  and  outs  of  C#'s  data  types,  how  to  work  with  data  in  your  program,  and  even 
figure  out  a  few  dirty  secrets  about  objects  (psstt...  objects  are  data,  too) 


this  is  a  new  chapter 
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not  my  type 


The  variable's  ty£e  determines  what 
kind  of  data  it  can  store 

There  are  fifteen  value  types  built  into  C#.  and  each  one  stores  a 
different  kind  of  data.  You’ve  already  seen  some  of  the  most  common 
ones,  and  you  know  how  to  use  them.  But  there  are  a  few  that  you 
haven’t  seen,  and  they  can  really  come  in  handy,  too. 


Value  types  you’ll  use  all  the  time 

It  shouldn’t  come  as  a  surprise  that  int,  string,  bool,  and  float  are  the  most 
common  types. 

*  int  can  store  any  whole  number  front  -2,147,483,648  to  2.147,483,647. 

*  string  can  hold  text  of  any  length  (including  the  empty  string 

*  bool  is  a  Boolean  value  it’s  either  true  or  false. 


A  whole  number  doe sr>  t 
have  a  decimal  point 


"float"  is  sho^  4*. 

*  float  can  store  any  decimal  number  from  ±1.5  x  I0"4j  to  ±3.4  x  1 0s8  with  up  “floating  po^t"  a 
to  7  significant  figures.  That  range  looks  weird  and  complicated,  but  it  s  actually  opposed  to  a  "(  d 
pretty'  simple.  The  "significant  figures”  part  means  the  precision  of  the  number:  point"  numb  r 

35,048,410,000,000,  1,743,059,  14.43857,  and  0.00004374155  all  have  seven  a|wjys  has" the  „  h 
significant  figures.  The  I03®  thing  means  that  you  can  store  any  number  as  large  as  number  ©t  dec  jl 
I 0“  (or  1  followed  by  38  zeroes) — as  long  as  it  only  has  7  or  fewer  significant  figures.p|j(.es 
On  the  other  end  of  the  range,  1 0'1,  means  that  you  can  store  any'  number  as  small 
as  10  *5  (or  a  decimal  point  followed  by  45  zeroes  followed  by  1)...  but,  you  guessed 
it,  as  long  as  it  only  has  7  or  fewer  significant  figures. 

The  “u"  in  uint  stands  (or  “unsigned", 

r  which  means  it  can't  be  negative  (so 
there's  no  minus  Sign). 

Once  upon  a  time,  computer  memory  w  as  really  expensive,  and  processors  were  really 

slow.  And,  believe  it  or  not,  if  you  used  the  wrong  type,  it  could  seriously  slow  down  your  ^ _ 

program.  Luckily,  times  have  changed,  and  most  of  die  time  if  you  need  to  store  a  whole  '\^  ^ 

number  you  ran  just  use  an  int.  But  sometimes  you  really  need  something  bigger...  and  J 

once  in  a  while,  you  need  something  smaller,  too.  That’s  why  C#  gives  you  more  options:  A  lot  ot  times,  it 


The  V 

stands  tor 

M  -  |M 

unsigned 


byte  can  store  any  whole  number  between  0  and  255. 
sbyte  can  store  any  whole  number  from  -127  to  128. 
short  can  store  any  whole  number  from  -32,767  to  32,768. 
ushort  can  store  any  whole  number  from  0  to  65,535. 
uint  can  store  any  whole  number  from  0  to  4,294.967,295. 
long  can  store  any  number  lietween  minus  and  plus  9  billion  billion, 
ulong  can  store  any  number  between  0  and  about  18  billion  billion. 


A  lot  ot  times,  it 
you're  using  these 
types  it's  because 
you're  solving  a 
problem  where 
it  really  helps  to 
have  the  “wrapping 
around"  ettect  that 
you'll  read  about  ih 
a  tew  minutes. 
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Types  for  storing  really  HUGE  and  really  tiny  numbers 

Sometimes  7  significant  figures  just  isn't  precise  enough.  And,  believe  it  or  not.  sometimes  I038 
isn't  big  enough  and  10",J  isn't  small  enough.  A  lot  of  programs  written  for  finance  or  scientific 
research  run  into  these  problems  all  the  time,  so  C#  gives  us  two  more  types: 

*  double  can  store  any  number  from  ±5.0  x  10  to  ±  1.7  x  lO’""  with  15-16 
significant  digit. 


The  double 
■type  is  actually 
as  common  as 
float-  A  lot 
,  of  people  use 
rt  all  the  time, 
and  rarely  use 
float 


decimal  can  store  any  number  from  ±  1 .0  x  10'28  to  ±7.9  x  I  (I-8  with  28-29 
significant  digits. 


V 


_ (\  literal  just  means  a  number  that  you 

\c  type  into  your  code  So  when  you  type 

Literals  have  types,  too  Mj.nt  i  =  5;"»  the  5  is  a  literal 

When  you  type  a  number  directly  into  your  C#  program,  you’re  using  a  literal...  and 
every  literal  is  automatically  assigned  a  type.  You  can  see  this  for  yourself  just  enter  this 
line  of  code  that  assigns  the  literal  14.7  to  an  int  variable: 

int  mylnt  =  14.7; 

Now  try  to  build  the  program.  You’ll  get  this: 


When  you  used  the 
l/alue  property  m 
your  numerieWpPown 
Control,  you  were 
usin$  a  decimal 


O  l  Cannot  Implicitly  convert  type  'double'  to  Int'.  An 
►  explidt  conversion  exists  (are  you  missing  a  cast?) 


That’s  the  same  error  you’ll  get  if  you  try  to  set  an  int  equal  to  a  double  variable.  \Vfint 
the  IDE  is  telling  you  is  that  the  literal  14.7  has  a  type  it’s  a  double.  You  can  change  ^ 
its  type  to  a  float  by  sticking  an  F  on  the  end  (1 4 . 7F).  And  1 4 . 7M  Is  a  decimal. 


A  few  more  useful  built-in  value  types 

Did  you  notice  how  the  byte  type  has  256  possible  values?  Well,  there’s  another  type 
that  also  has  256  possible  values:  char.  But  it’s  not  numeric;  you  use  it  to  store  a 
character.  Literal  values  for  char  are  always  inside  single  quotes  ( 'x' ,  '3' ).  You  can 
include  escape  sequences  in  the  quotes,  too  ( '  \  n'  is  a  line  break.  '  \  t '  is  a  tab). 

And  finally;  there’s  one  more  important  type:  object.  You've  already  seen  how  an 
object  can  inherit  from  another  one,  and  dial  object  can  in  turn  inherit  from  yet  a 
different  object.  At  the  top  of  every  inheritance  hierarchy  is  the  object  class  that’s  a 
special  type  that  every7  other  object  inherits  from.  That’s  really  useful,  because  it  means 
that  you  can  assign  any  value,  variable,  or  object  to  an  object  variable. 


if  you  -try  to  assign  a 
float  literal  -to  a  double 
or  a  decimal  literal  to  a 
float,  the  IDE  will  give 
you  a  helpful  message 
reminding  you  to  add 
the  right  suff  i*.  Cool/ 


* 


Vov’ll  learn  a  lot  more 
about  how  char  and 
byte  relate  to  each 
other  in  Chapt  er  c\. 


You  can  use  the  Windows  calculator  to  convert  between  decimal  (normal,  base-10)  numbers  and 
binary  numbers  (base-2  numbers  written  with  only  ones  and  zeroes) — put  it  in  Scientific  mode,  enter 
a  number,  and  click  the  Bin  radio  button  to  convert  to  binary.  Then  click  Dec  to  convert  it  back.  Now 
enter  some  of  the  upper  and  lower  limits  for  the  whole  number  types  (like  -32,767  and  255) 
and  convert  them  to  binary.  Can  you  figure  out  why  C#  gives  you  those  particular  limits? 
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i’ll  take  an  ice  cream  float  to  go 


A  variable  is  like  a  data  tO'go  cup 

All  of  your  data  takes  up  space  in  memory.  (Remember  die  heap 
from  last  chapter?)  So  part  of  your  job  is  to  think  about  how  much 
space  you’re  going  to  need  whenever  you  use  a  string  or  a  number  in 
your  program.  That’s  one  of  the  reasons  you  use  variables.  They  let 
you  set  aside  enough  space  in  memory  to  store  your  data. 


Think  of  a  variable  like  a  cup  that  you  keep  your  data  in.  C#  uses 
a  bunch  of  different  kinds  of  cups  to  hold  different  kinds  of  data. 
And  just  like  the  different  sizes  of  cups  at  the  coffee  shop,  diere  are 
different  sizes  of  variables,  too. 


S 


*A\olc 


tolr  W  hole 
to 

e*'iy  big. 


pt  »  "Sli  to 

«-»*»•  ft  iff 

A  ,kort  «ill  Ud  «U€  r—kt” 
up  to  I'L.'lW- 


byte  holds  numbers 
between  zero  and  Z55. 


These  are 


the  number  ot  b-ts  ot  ^  set  as.de  tor  the  variable  when  you  declare  it 


Numbers  that  have  decimal  places  are  stored  differently  than 
whole  numbers.  You  can  handle  most  of  your  numbers  that  have 
decimal  places  using  float,  the  smallest  data  type  diat  stores 
decimals.  If  you  need  to  be  more  accurate,  use  a  double,  and  if 
you're  writing  a  scientific  application  where  the  numbers  need  to 
be  extremely  accurate,  the  decimal  type  has  the  most  precision. 

It’s  not  always  about  numbers,  though.  You  wouldn’t  expect  to 
get  hot  coffee  in  a  plastic  cup  or  cold  coffee  in  a  paper  one.)  The 
C#  compiler  also  can  handle  characters  and  non-numeric  types. 
The  char  type  holds  one  character,  and  string  is  used  for  lots 
of  characters  “strung"  together.  There’s  no  set  size  for  a  string 
v  ariable,  either.  It  expands  to  hold  as  much  data  as  you  need 
rto  store  in  it.  The  bool  data  type  is  used  to  store  true  or  false 
values,  like  the  ones  you've  used  for  your  if  statements. 


float  double 

32  64 


These  tyes  **  W 
tracts  barker 
variables  n'°re 
det.mal  ?la«s. 


decimal 

128 


string  is  pretty  un.gue  ft's  the  only 
data  type  without  a  set  size,  except  tor 
objects  f think  about  that  tor  a  bit). 


bool 

8 


char 

16 


string 

depends  on 
the  size 
of  the  string 
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10  pounds  of  data  in  a  5  pound  bag 


When  you  declare  your  variable  as  one  type,  that's  how  your 
compiler  looks  at  it.  Even  if  the  value  is  nowhere  near  the  upper 
boundary  of  the  type  you've  declared,  die  complier  will  see  the  cup 
it’s  in,  not  the  number  inside.  So  this  won't  work: 

int  leaguesUnderTheSea  =  20000; 


short  smallerLeagues  =  leaguesUnderTheSea 


20,000  would  fit  into  a  short,  no  problem.  But  since 
leaguesUnderTheSea  is  declared  as  an  int,  the  compiler  sees 
it  as  int-sized  and  considers  it  too  big  to  put  in  a  short  container. 
The  compiler  won’t  make  those  translations  for  you  on  the  fly.  You 
need  to  make  sure  that  you're  using  the  right  type  for  the  data 
you're  working  with. 


™  SChse 
7^  M  a  larqei 

d  **?•  ihat  wo, 

,c  tup?  7i 

>9  io  pro id 


Three  of  these  statements  won’t  compile,  either  because  they're 
trying  to  cram  too  much  data  into  a  small  variable  or  because 
they're  putting  the  wrong  type  of  data  in.  Circle  them. 


int  hours  =  24 


string  taunt  =  "your  mother 


78000 


bool  isDone 


char  initial 


int  balance  =  345667  -  567 


string  months 
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casting  call 


Even  when  a  number  is  the  right  size,  you 
can't  just  assign  it  to  any  variable 

Let's  see  what  happens  when  you  try  to  assign 
a  decimal  value  to  an  int  variable. 

Create  a  new  project  and  add  a  button  to  it.  Then  add  these  lines  to  the 
button’s  Click  ( )  method: 

decimal  myDecimalValue  =  10; 
int  mylntValue  =  myDecimalValue; 

MessageBox. Show ("The  mylntValue  is  "  +  mylntValue); 
Try  building  your  program.  Uh-oh — you  got  an  error  that  looks  like  this: 


4r  ^ 

Do  tills 


Error  Let 


Q  l  Error  |  j _ftowamngi  DOMesages 


Deorpaon 

O  1  Carnot  imptatty  convert  type  'deomal'  to  Int .  an  expiot  conversion  easts  (are  you  meang  a  cast?) 


Make  the  error  go  away  by  casting  the  decimal  to  an  int.  Once  you  change 
the  second  line  so  it  looks  like  this,  your  program  will  compile  and  run: 


Chetk  out  ho* 

the  IDE  fibred 

.  out  that  you 
were  probably 
missing  a  cast 


int  mylntValue  =  (int)  myDecimalValue; 


So  what  happened? 


Here's  where  you  east  the 
decimal  value  to  an  int- 


The  compiler  won’t  let  you  assign  a  value  to  a  variable  if  it’s  die  wrong  type — even 
if  that  variable  can  hold  the  value  just  line  because  that’s  the  underlying  cause 
behind  an  enormous  number  of  bugs.  When  you  use  casting,  you’re  essentially 
making  a  promise  to  the  compiler  that  you  know  the  types  are  different,  and  that 
in  this  particular  instance  it’s  okay  for  C#  to  cram  the  data  into  the  new  variable. 

Sharpen  your  pencil _ 

v  Solution 


Take  a  minute  to  flip  ya£k 
to  the  beginning  of  the  last 
Chapter  and  check  out  how 
You  used  cast  mg  when  you 

passed  the  NumericMpDown. 

Mue  to  the  Talker  Tester 
tor  ». 


Three  of  these  statements  won't  compile,  either  because  they're 
trying  to  cram  too  much  data  into  a  small  variable  or  because 
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When  you  cast  a  value  that's  too 
big,  C#  will  adjust  it  automatically 

You’ve  already  seen  that  a  decimal  can  be  cast  to  an 
int.  It  turns  out  that  any  number  can  be  cast  to  any  other 
number.  But  that  doesn’t  mean  the  value  stays  intact 
through  the  casting.  If  you  cast  an  int  variable  that’s  set 
to  365  to  a  byte  variable,  365  is  too  big  for  the  byte.  But 
instead  of  giving  you  tut  error,  the  value  will  just  wrap 
around,  for  example,  256  cast  to  a  byte  will  have  a  value 
of  0.  257  would  be  converted  to  1 , 258  to  2,  etc.,  up  to  365, 
which  will  end  up  being  109.  And  once  you  get  back  to 
255  again,  the  conversion  value  “wraps”  back  to  zero. 


Hey,  I've  been  combining 
numbers  and  strings  in  my 
message  boxes  since  I  learned 
about  loops  in  Chapter  2!  Have 
I  been  casting  this  whole 
time? 


Yes!  The  +  operator  casts  for  you. 

What  you’ve  been  doing  is  using  the  + 
operator,  which  does  a  lot  of  casting  for 
you  automatically  but  it's  especially 
smart  about  it.  When  you  use  +  to  add  a 
number  or  boolean  to  a  string,  then  it'll 
automatically  convert  that  value  to  a  string, 
loo.  If  you  use  +  (or  *,  /  or  -)  with  two 
different  types,  it  automatically  casts  the 
smaller  type  to  the  bigger  one.  Here’s 
an  example: 

int  my Int  =  36; 

-Afloat  myFloat  =  16.4?; 
myFloat  =  mylnt  +  myFloat; 

Since  an  int  can  fit  into  a  float  but  a 
float  can’t  lit  into  an  int,  the  +  operator 
casts  mylnt  to  a  float  before  adding  it  to 
myFloat. 


i 


*4 


When  you're 
assigning  j  number 
value  -to  a  -float, 

r*  to  add  an 

io  the  end  of 
the  number  to  tell 
the  Compiler  that 
it  s  a  float,  and 
not  a  double. 


vIp!"  tT  mystry  ** Kow  ***** 

P  the  numbers— 

Ultuhu,  n  S£,„Wi£ 
r°dc'  a"d  ukiMe  345  Mod  lit 

a  modu,°  calculation;.  uL .  r!r 


You'll  get 


Sharpen  your  pencil 


^  You  can't  always  cast  any  type  to  any 
other  type.  Create  a  new  project,  drag  a 
button  onto  a  form,  and  type  these  statements 
into  its  method.  Then  build  your  program — it  will 
give  lots  of  errors.  Cross  out  the  ones  that  give 
errors.  That'll  help  you  figure  out  which  types  can 
be  cast ,  and  which  can't! 

int  mylnt  =  10; 

byte  myByte  =  (byte) mylnt; 

double  myDouble  =  (double) myByte; 

bool  myBool  =  (bool) myDouble; 

string  myString  =  "false"; 

myBool  =  (bool) myString; 

myString  =  (string) mylnt; 

myString  =  mylnt. ToString () ; 

myBool  =  (bool ) myByte; 

myByte  =  (byte) myBool; 

short  myShort  =  (short) mylnt; 

char  myChar  =  *x' ; 

myString  =  (string) myChar; 

long  my Long  =  (long) mylnt; 

decimal  myDecimal  =  (decimal )myLong; 

myString  =  myString  +  mylnt  +  myByte 
+  myDouble  +  myChar; 


you  are  here  ► 


129 


a  true  convert 


C#  does  some  casting  automatically 

There  are  ivvo  important  conversions  that  don’t  require 
you  to  do  the  casting.  The  first  is  done  automatically  any 
time  you  use  arithmetic  operators,  like  in  this  example: 


long  1  =  139401930; 
short  s  =  516; 
double  d  =  1 
d  =  d  /  123.456; 

MessageBox.  Show  ("The  answer  is  "  (+J d) ; 

This  +  operator  is  smart  / 
enofcjk  to  Convert  the  decimal ' 
to  a  string. 

The  other  way  C#  converts  types  for  you  automatically  is  when 
you  use  the  +  operator  to  concatenate  strings  (which  just 
means  sticking  one  string  on  the  end  of  another,  like  you’ve  been 
doing  with  message  boxes).  When  you  use  +  to  concatenate 
a  string  with  something  that’s  another  type,  it  automatically 
converts  the  numbers  to  strings  for  you.  Here’s  an  example.  The 
first  two  lines  are  fine,  but  the  third  one  won't  compile. 

long  x  =  139401930; 

MessageBox. Show ("The  answer  is  "  +  x) ; 
MessageBox. Show (x) ; 

The  C#  compiler  spits  out  an  error  that  mentions  something 
about  invalid  arguments  (an  argument  is  another  name  for 
a  method’s  parameter).  That’s  because  the  parameter  for 
MessageBox .  Show  ( )  is  a  string,  and  this  code  passed 
a  long,  which  is  the  wrong  type  for  the  method.  But  you  can 
convert  it  to  a  string  really  easily  by  calling  its  ToString  () 
method.  That  method  is  a  member  of  every  value  type 
and  object.  (All  of  the  classes  you  build  yourself  have  a 
ToString  ( )  method  that  returns  the  class  name.)  That's 
how  you  can  convert  x  to  something  that  MessageBox . 

Show  ( )  can  use: 

MessageBox . Show (x . ToString  ( ) ) ; 


You  can't  always  cast  any  type  to  any  other 
type.  Create  a  new  project,  drag  a  button  onto  a 
form,  and  type  these  statements  into  its  method. 
Then  build  your  program — it  will  give  lots  of 
errors.  Cross  out  the  ones  that  give  errors.  That'll 
help  you  figure  out  which  types  can  be  cast ,  and 
which  can’t! 

int  mylnt  =  10; 

byte  myByte  =  (byte) mylnt; 

double  myDouble  =  (double) myByte; 

bcrrl— myBool  -  (hnnl  )  wyDouble; — 
string  myString  =  "false"; 

-wyBool  - — Qwi;*jr)  my Oiling, - 
ifty  ST  i  i  i  iq  -  — ( g  t  r  i  ngimy  I  n  t ; 
myString  =  mylnt .ToString  () ; 

-sayRnnL — = — (■)»■. ol )  myByr,<a; 

— tbyte)  myDool  t — 

short  myShort  =  (short) mylnt; 

char  myChar  =  'x'  ; 

-myCtring^ — (string)  myf?tiar ; 

long  myLong  =  (long) mylnt ; 

decimal  myDecimal  =  (decimal) myLong; 

myString  =  myString  +  mylnt  +  myByte 
+  myDouble  +  myChar; 


The  -  operator  subtracted 
the  short:  -from  the  lon^, 
and  Converted  the  result: 
to  a  double 
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Whew  you  call  a  method,  the  variables  must 
match  the  types  of  the  parameters 

Try  calling  MessageBox .  Show  (123)  passing  MessageBox.ShovvO  a 
literal  ( 1 23)  instead  of  a  string.  The  IDE  won’t  let  you  build  your  program. 
Instead,  it'll  show  you  an  error  in  the  IDE:  ‘Argument  ‘1’:  cannot  convert  from 
‘int’  to  ‘string’.” 

But  Message  Box. Show()  isn’t  the  only  method  that  will  give  you  compiler 
errors  if  you  try  to  pass  it  a  variable  whose  type  doesn't  match  the  parameter. 
All  methods  will  do  that,  even  the  ones  you  write  yourself.  Go  ahead  and  try 
typing  this  completely  valid  method  into  a  class: 


public  int  MyMethod(bool  yesNo)  { 


if  (yesNo)  { 
return  45; 
)  else  { 

return  61; 

I 


) 


;m,nder-the  todt  ?asS  it 


When  the 
compiler  gives 
you  an  "invalid 
arguments"  error, 
it  means  that 
you  tried  to  call 
a  method  with 
variables  whose 
types  didn’t  match 
the  method’s 
parameters. 


It  works  just  fine  if  you  pass  it  what  it  expects  (a  bool) — call  MyMethod  (true) 
MyMethod  (false) ,  and  it  compiles  just  fine. 


But  what  happens  if  you  pass  it  an  integer  or  a  string  instead?  The  IDE  gives  you  a 
similar  error  to  the  one  that  you  got  when  you  passed  123  to  MessageBox .  Show  ( ) . 
Now  try  passing  it  a  boolean,  but  assigning  the  return  value  to  a  long  or  passing  it  on  to 
MessageBox .  Show  ( ) .  That  won't  work,  eidier  the  method  returns  an  int,  not  a 
long  or  the  string  that  MessageBox .  Show  ()  expects. 


Mh  assign 

anything  to  a  variable, 
parameter,  or  -field 

with  the  type  object 


if  statements  aUys  test  to  see  if  something's  true 

pid  you  notide  bow  we  wrote  our  if  statement  like  tb.s- 
r  f 


enpl.citly  ch«k  t»  'f  *  'x»ks»  is  **  ~  W“- 
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this  table  reserved 


There  are  about  77  reserved  words  in  C#.  These  are  words  reserved  by  the  C#  compiler;  you 
can't  use  them  for  variable  names.  You'll  know  them  all  really  well  by  the  time  you  finish  the  book 
Here  are  some  you've  already  used.  Write  down  what  you  think  these  words  do  in  C# 


namespace 


for 


class 


public 


else 


new 


using 


if 


while 
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Create  a  reimbursement  calculator  for  a  business  trip.  It  should  allow  the  user  to  enter  a  starting 
odometer  reading  and  an  ending  odometer  reading.  From  those  two  numbers,  it  will  calculate 
how  many  miles  she's  travelled  and  figure  out  how  much  she  should  be  reimbursed  if  her 
company  pays  her  $.39  for  every  mile  she  puts  on  her  car. 


Start  with  a  new  Windows  project. 

Make  the  form  look  like  this: 


ft  bold. 


Starting  Mileage  tl 

Endng  Mileage  1 

:  V— 

is  11 

AmoirilOwe^  Iabel4 

|  Calculate 

rid  o-p 
-be  minimize 
Jnd  mJximizi 
K'tfcons. 


range  tor 


Tte 

these  -fields  should 

i-mm 


When  you're  done  with  the  Form,  double-click  on  the 
button  to  add  some  code  to  the  project. 


Create  the  variables  you'll  need  for  the  calculator. 

Put  the  variables  in  class  definition  at  the  top  of  Forml.  You  need  two  whole  number 
variables  to  track  the  starting  odometer  reading  and  the  ending  odometer  reading.  Call 
them  startingMileage  and  endingMileage.  You  need  three  numbers  that 
can  hold  decimal  places.  Make  them  doubles  and  call  them  milesTraveled, 
reimburseRate,  and  araountOwed.  Set  the  value  for  reimburseRate  to  .39. 


Make  your  calculator  work. 

Add  code  in  the  buttonl  Click  ( )  method  to: 


*  Make  sure  that  the  number  in  the  Starting  Mileage  field  is  smaller  than  the  number  in 
the  Ending  Mileage  field.  If  not,  show  a  messagebox  that  says  “The  starting  mileage 
must  be  less  than  the  ending  mileage”.  Make  the  title  for  the  message  box  “Cannot 
Calculate”. 


♦  Subtract  the  starting  number  from  the  ending  number  and  then  multiply  it  by  die 
reimburse  rate  using  these  lines: 

milesTraveled  =  endingMileage  -=  startingMileage; 
amountOwed  =  milesTraveled  *=  reimburseRate; 


label4.Text  =  "$"  +  amountOwed; 

Run  it. 

Make  sure  it’s  giving  the  right  numbers.  Try  changing  the  starting  value  to  be  higher  than 
the  ending  value  and  make  sure  it’s  giving  you  the  message  box. 
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something’s  wrong... 


Here's  the  code  for  the  first  part  of  the  exercise 


&teRci$e 

§OLut\OH 


public  partial  class  Forml  :  Form 


int  startingMileage; 
int  endingMileage; 
double  milesTraveled; 
double  reimburseRate  =  .39; 
double  amountOwed; 
public  Forml ()  { 

InitializeComponent ( ) ; 


■  int  works  great  (or  wKo(e 

"u*bers  Tk,s  »umber  could 

9°  **•  the  *ay  up  ho 

S®  a  short  or  a  byte 

"w’-fc  Cut  rt 


P,d  you  remember 

InitializeComponent  ( )  ;  \,ave 

)  to  tban^e  the 

decimal  wa'we  *ro 

private  void  buttonl_Click  (object  sender,  EventArgs  e)  (  numeritUpDo'*"' 


startingMileage  =  (int)  numericUpDownl .Value;  - t 

endingMileage  =  ( int)  numericUpDown2  .Value;  ^ 
if  (startingMileage  <=  endingMileage) { 

milesTraveled  =  endingMileage  -=  startingMileage; 
amountOwed  =  milesTraveled  *=  reimburseRate; 
label4.Text  =  "$"  +  amountOwed; 

}  else  { 


Control  to  an  int. 


Ttis  block  is 
supposed  to  figure 
out  bow  many 
miles  were  traveled 
Jnd  then  multiply 
them  by  the 

reimbursement  rate 


MessageBox . Show ( 

'The  starting  mileage  must  be  less  than  the  ending  mileage", 

"Cannot  Calculate  Mileage") ; 

We  used  an  alternate  way 

*  ^  °t  the  MessageBox 

V,  Show 0  method  here  We  gave 
it  two  parameters-  the  first 

This  button  seems  to  work,  but  it  has  a  ",esw9e  to  display, 

pretty  big  problem.  Can  you  spot  it?  trtVbar^  ***  ^°es 
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Now  add  another  button  to  the  form. 

Make  it  so  that  the  number  of  miles  traveled  is  displayed 
on  the  form  after  you’ve  calculated  the  amount  owed. 


When  you’re  done  with  the  Form,  double-click  on  the 
Display  Miles  button  to  add  some  code  to  the  project. 


One  line  should  do  it. 

All  we  need  to  do  is  get  the  form  to  display  the  milesTraveled  variable,  right?  So  this  line 
should  do  that: 

private  void  button2_Click (object  sender,  EventArgs  e)  { 

Messagebox. Show (milesTraveled  +  "  miles",  "Miles  Traveled"); 

} 


Run  it. 

Type  in  some  values  and  sec  what  happens. 


Urn,  something's  not  right... 

The  number  of  miles  always  matches  the  amount  owed.  Why? 
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operators  are  standing  by 


Combining  s  with  an  operator 

Take  a  good  look  at  the  operator  we  used  to  subtract  ending  mileage  from 
starting  mileage  (-— I.  The  problem  is  it  doesn't  just  subtract,  it  also  assigns 
a  value  to  the  variable  on  the  left  side  of  the  subtraction  sign.  The  same 
thing  happens  in  the  line  where  we  multiply  number  of  miles  traveled  by  the 
reimbursement  rate.  We  should  replace  the  -=  and  the  *=  with  just  -  and  *: 


private  void  buttonlClick (object  sender,  EventArgs  e) 

{ 

startingMileage  =  (int)  numericUpDownl .Value; 
endingMileage  =  (int) numericUpDown2 .Value; 
if  (startingMileage  <=  endingMileage) { 

milesTraveled  =  endingMileage ^^^startingMileage; 
amountOwed  =  milesTraveled  ©  reimburseRate; 
label4.Text  =  +  amountOwed) 

}  else  ( 


MessageBox.  Show  ("The  starting  milAge  number  must 

be  less  than  the  eliding  mileage  number", 
"Cannot  Calculate  ly^leage")  ; 


This  is  better-row 
your  tode  won’t  modify 

endingMileage  and' 
milesTraveled- 


These  are 
railed  tomyourd 

operators.  This 
one  subtr arts 
startin$M>lea5e 
■fro**  endm^Mileay 
but  also  assiyu 
the  new  value  to 
endingMileage  and 
milesTraveled  at 

the  same  time 


milesTraveled  =  endingMileage  -  startingMileage; 
amountOwed  =  milesTraveled  *  reimburseRate; 


So  can  good  variable  names  help  you  out  here?  Definitely!  Take  a 
close  look  at  what  each  variable  is  supposed  to  do.  You  already  get  a  lot  of 
clues  from  the  name  milesTraveled — you  know  that’s  the  variable  that 
the  form  is  displaying  incorrecdy,  and  you've  got  a  good  idea  of  how  that 
value  ought  to  be  calculated.  So  you  can  take  advantage  of  that  when  you’re 
looking  through  your  code  to  try  to  track  down  the  bug.  It'd  be  a  whole  lot 
harder  to  find  the  problem  if  the  incorrect  lines  looked  like  this  instead: 


mT 

aO 


eM  -=  sM; 
mT  *=  rR; 
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Objects  are  variables,  too 

So  far,  we’ve  looked  at  objects  separate  from  other  types.  But 
an  objec  t  is  just  another  data  type.  Your  code  treats  objects 
exactly  like  it  treats  numbers,  strings,  and  booleans.  It  uses 
variables  to  work  with  them: 


Using  an  int 

(l)  Write  a  statement  to  declare  the  integer. 

int  mylnt; 


.Assign  a  value  to  the  new  variable. 


o 


o 


Using  an  object 


Write  a  statement  to  declare  the  object. 

Dog  spot;  When  you  Wave  a  t 'a« 

like  Po^  you  use  it  as 
■the  tyye  in  a  variable 
declaration  statement 

Assign  a  value  to  the  object. 


mylnt  =  3761; 


spot  =  new  Dog() ; 


© 


Use  the  integer  in  your  code. 


o 


Check  one  of  the  object’s  fields. 


while  (i  <  mylnt)  { 


while  (spot. Happy)  { 


So  it  doesn't  matter  if  I’m 
working  with  an  object  or  a  value.  If 
it’s  going  into  memory,  and  my  program 
needs  to  use  it,  I  use  a  variable. 


Objects  are  just  one  more  type  of 
variable  your  program  can  use. 

If  your  program  needs  to  work  with  a  whole 
number  that’s  really  big,  use  a  long.  If  it  needs 
a  whole  number  that’s  small,  use  a  short.  If  it 
needs  a  yes/no  value,  use  a  boolean.  And  if  it 
needs  something  that  barks  and  sits,  use  a  Dog. 
No  matter  what  type  of  data  your  program 
needs  to  work  with,  it'll  use  a  variable. 
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get  the  reference 


Refer  to  your  objects  with  reference  variables 

When  you  create  a  new  object,  you  use  code  like  new  Guy.  But  that’s  not  enough; 
even  though  that  code  creates  a  new  Guy  object  on  the  heap,  it  doesn’t  give  you  a 
way  to  access  that  object.  You  need  a  reference  to  the  object.  So  you  create  a 
reference  variable:  a  variable  of  type  Guy  with  a  name,  like  Joe.  So  Joe  is  a 
reference  to  the  new  Guy  object  you  created.  Anytime  you  want  to  use  that  particular 
guy,  you  can  reference  it  with  the  reference  variable  called  Joe. 

So  when  you  have  a  variable  that  is  an  object  type,  it's  a  reference  variable:  a 
reference  to  a  particular  object.  Take  a  look: 


That's  tailed 
instantiating 
the  object 


Here's  the  heap  beWe  y<*r 
code  runs.  Nothing  there- 


This  variable  public  partial  class  Forml  :  Form 

is  na*"ed 

Joe,  and  will  Guy  Jog  ; 

reference 

an  object  of/  public  Forml  ( ) 
type  %  { 

InitializeComponent () ; 


Joe  =  new  Guy 


V 


>  \ 

i  's — /\t~ 

This  is  the  ..  and  this  is  the 

reference  variable...  ^  ^ 

fiow  refers  to 


Creating  a  reference  is  like  making  a  label 
with  a  label  F*aker— instead  of  sticking  it 
on  you r  stuff,  you're  usm9  it  to  label  an 
object  so  you  can  refer  to  it  later 


Here’s  the  heap  after 
this  code  runs.  There  S  an 
object,  with  the  variable 
Joe  referring  to  it  — 


-r  \ _ 

>tJy  ob'^c 


The  OH L-Y  way  to 
^ference  this  9uy  object 
“  ihe  reference 
triable  called  Joe. 
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References  are  like  labels  for  your  object 


In  your  kitchen,  you  probably  have  a  container  of  salt  and  sugar.  If  you 
switched  their  labels,  it  would  make  for  a  pretty  disgusting  meal — even 
though  the  labels  changed,  the  contents  of  the  containers  stayed  the  same. 
References  are  like  labels.  You  can  move  labels  around,  point  them  at 
different  things,  but  it’s  the  object  that  dictates  what  methods  and  data  are 
available,  not  the  reference  itself. 


When  your  code 
needs  to  work 


Ah  I  InsianCe  of  fj* 
class  js  keeping  a 
"to  ihis  objeci  in  a  variable 
called  "Dad". 


|S  reference  variable,  b 
they  all  point  b>  the  » 
SA/VJE  ^uy  object  j 


This  object  is  of  type  ^uy 
It’s  a  SINGLE  object  with 
MULTIPLE  references 


frf 

r  V*'ab,e  "Joe"  that 

•**«««.  this 


with  an  ohject  in 
memory,  it  uses  a 
reference,  which 
is  a  variable 
whose  type  is 
a  class  of  the 
object  it’s  going 
to  point  to.  A 
reference  is  like 
a  label  that  your 
code  uses  to  talk 
about  a  specific 
ohject. 


You  never  refer  to  your  object  direcdy.  For  example,  you  can't  write  code 
like  Guy .  GiveCash  ( )  if  Guy  is  your  object  type.  The  C#  compiler  doesn't 
know  which  Guy  you’re  talking  about,  since  you  might  have  several 
instances  of  Guy  on  the  heap.  So  you  need  a  reference  variable,  like  j  oe, 
that  you  assign  to  a  specific  instance,  like  Guy  j  oe  =  new  Guy  ( ) . 

Now,  you  can  call  methods,  like  joe  .  GiveCash  ( ) .  joe  refers  to  a  specific 
instance  of  the  Guy  class,  and  your  C#  compiler  knows  exactly  which 
instance  to  use.  And,  as  you  saw  above,  you  might  have  multiple  labels 
pointing  to  the  same  instance  So  you  could  say  Guy  dad  =  joe.  and 
then  call  dad .  GiveCash  ( ) .  That’s  okay,  too — that's  what  Joe’s  kid  does 
every  day. 


- -  OT  Bi-r-rerent 

™  thin,,  Eath 

£  W*  te  a  d,tW 
that  «*>akes  seMe  m 


you  are  here  ► 


139 


that's  sanitation  engineer  thank  you  very  much 


If  there  aren't  any  wore  references, 
your  object  gets  garbage  collected 

If  all  of  the  labels  come  off  of  an  object,  no  programs  can  access  that 
object  anymore.  That  means  C#  can  mark  the  object  for  garbage 
collection.  That's  when  C #  gets  rid  of  any  unreferenced  objects,  and 
reclaims  the  memory  those  objects  took  up  for  your  program’s  use. 


For  an  object 
to  stay  in  tke 
keap,  it  kas  to 
ke  reference d. 


(Q)  Here's  some  code  that  creates  an  object. 

Guy  joe  =  new  Guy() 

{  Name  =  "Joe",  Cash  =  50 


The  first  line  had  a  declaration 
•that  Created  the  label  The 
second  line  Created  the  object 
and  slapped  the  label  on  it 


V  ob'y2^ 


Wken  tke 
last  reference 
to  tke  object 
disappears,  so 
does  tke  object. 


Now  let's  create  a  second  object. 

Guy  bob  =  new  Guy ( ) 

{  Name  =  "Bob",  Cash  =75  }; 

N,7  **  ***  two  4„y  ^  , 
•nstanCes,  and  ^ 
variables  C  r«+erenCe 
Cs  °"c  +or  each  4uy 


o  Let's  take  the  reference  to  the  first  object,  and 
change  it  to  point  at  the  second  object. 

joe  =  bob; 

Now  joe  is  pointing  to  the  same 
object  as  bob 


t 


-  M  there  is  no  longer 
a  reference  to  the 
first  object- 


•  so  C#  marks  the 
object  -for  garbage 
Collection,  and  trashes 
't.  It  s  gone/ 
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Typecross 

Take  a  break,  and  sit  back  and 
give  your  right  brain  something 
to  do.  It’s  your  standard 
crossword;  all  of  the  solution 
words  are  from  this  chapter. 

When  you’re  done,  turn  the 
page,  and  take  on  the  rest 
of  the  chapter. 


Across 

1 .  You  can  combine  the  variable  declaration  and  the _ 

_  into  one  statement 

4.  When  an  object  no  longer  has  any  references  pointing  to  it, 
it's  removed  from  the  heap  using _ collection 

8.  A  variable  declaration  always  starts  with  this 

10,  The  type  that  holds  the  biggest  numbers 

1 1  The  type  that  stores  a  single  letter  or  number 

12.  If  you  never  set  this  for  a  variable,  your  program  won't 
compile 

13.  A  variable  that  points  to  an  object 

14.  What  (int)  does  in  this  line  of  code:  x  =  (int)  y; 


15.  The  four  whole  number  types  that  only  hold  positive 
numbers 

Down 

2.  The  second  part  of  a  variable  declaration 

3.  Variable  names  like  myBigNumber  and  bobTheDog  use  this 
style  of  capitalization 

5  What  your  program  uses  to  work  with  data  that’s  in  memory 

6.  What  you're  doing  when  you  use  the  +  operator  to  stick  two 
stnngs  together 

7.  "namespace”,  “for",  “while",  “using"  and  “new"  are  examples 

of _ words 

9.  Every  object  has  this  method  that  converts  it  to  a  string 

- ►  Answers  on  page  162. 
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so  many  labels 


Multiple  references  and  their  side  effects 


You’ve  got  to  be  careful  when  you  start  moving  around  reference 
variables.  Lots  of  times,  it  might  seem  like  you're  simply  pointing 
a  variable  to  a  different  object.  But,  you  could  end  up  removing  all 
references  to  another  object  in  die  process.  That's  not  a  bad  thing, 
but  it  may  not  be  what  you  intended.  Take  a  look: 


Dog  rover  =  new  Dog(); 
rover. Breed  =  "Greyhound"; 


Objects: _ 

References:  ^ 


Rover  is  a  D03  object  with  a 
Breed  -field  called  greyhound 


Dog  f ido  =  new  Dog ( ) ; 
fido. Breed  =  "Beagle"; 
Dog  spot  =  rover; 


Objects: 
References:  ^ 


Fido  is  another  Doo, 

But  Spot  is  just 
reference  to  the  f  irst  object 


O  Dog  lucky  =  new  Dog(); 

lucky. Breed  =  "Dachshund"; 
fido  =  rover; 


Objects:. 


References: 


Lucky  is  a  third  object- 
But  Fido  is  now  pointing 
to  Object  #1.  So,  Object 
#2.  has  no  references 
It’s  done  as  far  as  the 
program  is  concerned  — 


^°9  ob\^ 
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Now  it's  your  turn.  Here's  one  long  block  of  code.  Figure  out  how  many 
objects  and  references  there  are  at  each  stage.  On  the  right-hand  side, 
draw  a  picture  of  the  objects  and  labels  in  the  heap. 


Dog  rover  =  new  Dog ( ) ; 
rover. Breed  =  "Greyhound"; 
Dog  rinTinTin  =  new  Dog ( ) ; 
Dog  f ido  =  new  Dog ( ) ; 

Dog  quentin  =  Fido; 


Objects: 


References: 


Dog  spot  =  new  Dog ( ) ; 
spot. Breed  =  "Dachshund"; 
spot  =  rover; 


Objects: 


References: 


Dog  lucky  =  new  Dog(); 
lucky. Breed  =  "Beagle"; 
Dog  charlie  =  fido; 
fido  =  rover; 


Objects: 


References: 


rinTinTin  =  lucky; 

Dog  laverne  =  new  Dog(); 
laverne . Breed  =  "pug"; 


Objects: 


References: 


charlie  =  laverne; 
lucky  =  rinTinTin; 


Objects: 


References: 
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swapping  elephants 


Sharpen  your  pencil 
v  Solution 


Now  it's  your  turn.  Here's  one  long  block  of  code.  Figure  out  how  many 
objects  and  references  there  are  at  each  stage.  On  the  right-hand  side, 
draw  a  picture  of  the 


O 


o 


Dog  rover  =  new  Dog ( ) ; 
rover. Breed  =  "Greyhound"; 

Dog  rinTinTin  =  new  Dog(); 

Dog  fido  =  new  Dog(); 

Dog  quentin  =  Fido; 

^  One  new  Dog  object  is 

Created  but  Spot  is  the 
,  orsly  reference  to  it-  When 

/  Spot  is  set  =•  to  Rover, 

&  \ 


Objects:. 


References 


Dog  spot  =  new  Dog ( ) ; 
spot. Breed  =  "Dachshund"; 
spot  =  rover; 

Objects:  ^ 


that  object  goes  away 


References: 


Here  a  new  Dog  object  >s 
Created,  but  whenTido  is 
set  to  Rover,  Fido's  object 
_ _  {  #1  goes  away 


O 


Dog  lucky  =  new  Dog(); 

lucky. Breed  =  "Beagle" ;Charlie  was  set  to  Fido 
Dog  charlie  =  fido;  when  Fido  was  still  on 


fido  =  rover; 

Objects:  \ 


object  #3  Then,  after 
that,  Fido  moved  to  object 
#1,  leaving  Charlie  behind 


References 


.  1 


rinTinTin  =  lucky; 

Dog  laverne  =  new  Dog(); 
laverne . Breed  =  "pug"; 


Dog  lost  its 
last  reference,  and 
it  went  away 


Objects: 


References: 


charlie  =  laverne; 
lucky  =  rinTinTin; 


When  Lucky  moved  to 
Rin  Tin  Tins  object, 
the  old  Lucky  object 
disappeared 


Objects:. 


References: 


Here  the  references  move 
around  but  no  new  objects 
are  Created  And  setting 
Lucky  to  Rin  Tin  Tin  did 
nothing  because  they  already 
pointed  to  the  same  object- 
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ExenciSe 

O 


Create  a  program  with  an  elephant  class.  Make  two  elephant  instances  and  then  have  them 
switch  properties,  without  getting  any  Elephant  instances  garbage  collected. 


Start  with  a  new  Windows  Application  project. 

Make  the  form  look  like  this:  .  .  » 


,w,tv  d. s?Ws  tv"s  "e  5 
v 


vT 

ie 


Elephant 


Name 

EarSize 


WhoAml() 


This  $Wes  you  a  tlue  as 
{ O  whtft  WhoA^IO  should 
return  a  single  siring 

u/iik  4-Vm<L 


Create  the  Elephant  class. 

Add  an  Elephant  class  to  the  project.  Have  a  look  at  the  Elephant  class  diagram — you'll  need  an  int 
field  called  EarSize  and  a  String  field  called  Name.  (Make  sure  both  arc  public.)  Then  add  a  method 
railed  WhoAmI  ( )  that  displays  a  messagebox  that  tells  you  the  name  and  ear  size  of  the  elephant. 


Create  two  elephant  instances  and  a  reference. 

Add  two  Elephant  fields  to  the  Forml  class  (in  the  area  right  below  the  class  declaration)  named 
Lloyd  and  Lucinda.  Initialize  them  so  they  have  the  right  name  and  ear  size.  Hero  are  the 
Elephant  object  initializers  to  add  to  your  form: 


lucinda  =  new  Elephant  0  {  Name  =  "Lucinda",  EarSize  =  33  ); 

lloyd  =  new  Elephant!)  {  Name  =  "Lloyd",  EarSize  =40  }; 


O 

o 


Make  the  “Lloyd"  and  "Lucinda"  buttons  work. 

I  lave  the  Lloyd  button  call  lloyd.  WhoAmI  ( )  and  the  Lucinda  button  call  lucinda .  WhoAmI  ( ) . 


Hook  up  the  swap  button. 

Here’s  the  hard  part.  Make  the  Swap  button  exchange  the  two  references,  so  that  when  you  click 
Swap,  the  Lloyd  and  Lucinda  variables  swap  objects  and  a  “Objects  swapped”  box  is  displayed. 
Test  out  your  program  by  clicking  the  Swap  button  and  then  clicking  the  other  two  buttons.  The  first 
time  you  click  Swap,  the  Lloyd  button  should  pop  up  Lucinda’s  messagebox,  and  the  Lucinda  button 
should  pop  up  Lloyd’s  messagebox.  If  you  click  the  Swap  button  again,  everything  should  go  back. 


C#  garbage  collects  any  object  with  no  references  to  it.  So  here’s  your 
hint:  If  you  want  to  pour  a  glass  of  beer  into  another  glass  that’s  currently 
full  of  water,  you’ll  need  a  third  glass  to  pour  the  water  into... 
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hold  that  reference 


ExemZQ 

Solution 


Create  a  program  with  an  elephant  class.  Make  two  elephant  instances  and  then  have  them 
switch  properties,  without  getting  any  Elephant  instances  garbage  collected. 

This  is  the 

L  tlass  definition tode 
1 the  Blefhanits 

file  **  added  to  the 

orojeti  Wt 

the  V*)  System 
Endows  forms,  Ime 

at  the  to?  of  Y* 
tlass  Without  it,  the 
Messayfto*  statement 

vjon  t  work 


using  System. Windows . Forms; 

class  Elephant  { 

public  int  EarSize; 
public  String  Name; 

public  void  WhoAmI ()  { 

MessageBox.Show ("My  ears  are 
Name  +  "  says..."); 

} 


+  EarSize  +  "  inches  tall.' 


[Ws  the  Form/  tlass  tode 
From  Form  I  t 


If  y«*  jwt  L'1°Vf 

to  Utmda,  there  won  t 
be  an y  wort  references 
pointing  t O  Lloyd  and  . 
his  object  xill  I®6  'os^ 
That’s  why  yoi*  need 
to  have  the  Holder 
reference  hold  onto 
the  Lloyd  object 
Uc.nda  can  yt  there 


public  partial  class  Forml  :  Form  { 

Elephant  lucinda; 

Elephant  lloyd; 

public  Forml () 

t 

Initial izeComponent () ; 
lucinda  =  new  Elephant () 

{  Name  =  "Lucinda", 
lloyd  =  new  Elephant  ( ) 

(  Name  =  "Lloyd",  EarSize  =  40  ) ; 

) 


EarSize  =33  ); 


private  void  buttonl  Click (object  sender,  EventArgs  e)  { 
lloyd . WhoAmI ( ) ; 

) 

private  void  button2_Click (object  sender,  EventArgs  e)  { 
lucinda . WhoAmI ( ) ; 

} 

private  void  button3_Click (object  sender,  EventArgs  e)  { 
Elephant  holder,  u  .  new  for  tkt 

SVS,  * - s  «W  W—  „  don't  w*t  to 

lucinda  =  holder;  treate  another  instance  o+  bleyhant 

MessageBox.Show ("Objects  swapped") ; 


- 

Why  do  you  think  we  didn’t  add  a  SwapQ  method  to  the  Elephant  class? 
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Two  references  weans  TWO  ways 
to  change  an  object's  data 


Besides  losing  all  the  references  to  an  object,  when 
you  have  multiple  references  to  an  object,  you  can 
unintentionally  change  an  object.  In  other  words,  one 
reference  to  an  object  may  change  that  object,  while 
another  reference  to  that  object  has  no  idea  that 
something  has  changed.  Watch: 


Add  another  button  to  your  form. 


Add  this  code  for  the  button.  Can  you  guess  what’s  going  to  happen  when  you  click  it? 


This  statement 
says  to  set 
EarSize  to  ^12. 1 ' 
on  whatever 
object  the  lloyd 
reference  happens 
to  point  to. 


private  void  button4_Click  (object  sender,  EventArgs  e)  i^-Pter  this  code  runs, 

<  lloyd  and  lucinda 

lloyd  =  Lucinda;  —  — - - - - - ~  variables  reference  the 

. lloyd. EarSize  =  4321;  SA/VlE  Elephant  object 

lloyd.WhoAml  ()  ^  Vou’re  calling  tb«  .  \ 

'  wwM«  -»*  _V 

the  - 

U  Bvt  lloyd  points  at  the  same 
“fchih^  ‘thdi  lulihdd  docs 


OK,  go  ahead  and  click  the  new  button.  Wait  a  second,  that’s  the  Lucinda  messagebox. 
Didn’t  we  call  the  Who  Am  I  method  from  Lloyd? 


/ePhatf 


It’s  Utinda  S 

messagebo* 


But  we  set  this 
EarSize  using  the 
lloyd  reference!  What 
gives? 


«  —  'rp 

‘  /ephatf 


llovd  and  luCinda  are  now  interchangeable  Changes  to 

the  object  that  BOUtavc  fo-t." I  ^ 


Note  that  the 
data  is  NOT  being 

overwritten— the 

only  things  changing 
are  the  references 
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pick  an  object  out  of  a  line-up 


A  special  case:  arrays 


If  you  have  to  keep  track  of  a  lot  of  data  of  the  same  type,  like  a  list  of  heights 
or  a  group  of  dogs,  you  can  do  it  in  an  array  like  you  used  when  you  made 
the  sandwich  menus  for  Sloppy  Joe.  What  makes  an  array  special  is  that  it’s  a 
group  of  variables  that’s  treated  as  one  object.  An  array  gives  you  a  way  of 
storing  and  changing  more  than  one  piece  of  data  without  having  to  keep  track 
of  each  variable  individually.  When  you  create  an  array,  you  declare  it  just  like 
any  other  variable,  with  a  name  and  a  type: 


5vrld  £rbme 

the  -y/Way  liable  with 
'wwloaiioh  -  ju si  like  X, 

boolQ  myArray  =  new  boo|f/5J; 


You  declare  a»  array  by 
s?et.^y«r>5  its  type, 
by  square  brackets- 


You  use  the 


bool [ ]  myArray ; 
myArray  =  new  bool [15] 


1  otJ ect  So  an 

re"'/  a  ki*  of 

referee  variable. 


myArray [ 4 ]  =  true ; 


Tb\s  array  bas  15 

elements  within  it- 


Use  each  element  in  an  array  like 
it  is  a  normal  variable 


This  line  sets  tbe  value  of  tbe  f  ifth  ^ 
element  o-f  myArray  to  true-  It's  tbe 
fifth  one  because  tbe  first  is  myArray£03, 
tbe  second  is  my  Array  Cl  3,  etc 


in  memory,  tbe  array 


stored  as  one 


chunk 


Here’s  an  example  of  code  that  declares  and  fills  up  an 
array  —  and  what’s  happening  on  the  heap  when  you  do  it. 
The  first  element  in  the  array  has  an  index  of  zero. 


there  are  "^p'e 

variables  W.thm  -t- 


Tbe  type  - 
o-f  each 
element  in 
tbe  array 

You 

v-eferenCe 

these  by 
inde*,  but 
each  one 

works 

essentially 
like  a  normal 
int  variable- 


int [ ]  heights ; 


name 


7  int  variables 


heights  =  new  int [7]; 
heights [0]  =  68; 
heights [1]  =  70; 
heights [2]  =  63; 
heights [3]  =  60; 
heights [4]  =  58; 
heights [5]  =  72; 
heights [6]  =  74; 


ininininniain 


int  int 


int  int  int  int  int 


Notice  that  tbe  array  is  an  object, 
even  though  tbe  7  elements  are 
primitives  variables. 
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Arrays  caw  cowtaiw  a  buwch  of 
reference  variables,  too 

You  can  create  an  array  of  object  references  just  like  you  create 
an  array  of  numbers  or  strings.  Arrays  don’t  care  what  the  type  of 
variable  is  that  it  stores;  it’s  up  to  you.  So  you  can  have  an  array  of 
ints,  or  an  array  of  Duck  objects,  with  no  problem. 

Here’s  code  that  creates  an  array  of  7  Dog  variables.  The  line  that 
initializes  the  array  only  creates  reference  variables.  Since  there  are 


Wlien  you  set  or 
retrieve  an  element 
from  an  array,  the 
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sloppy  joe  sez:  “ it's  not  old,  it's  vintage" 


Welcome  to  Sloppy  Joe's  Budget  House  o'  discount  Sandwiches! 

Sloppy  Joe  has  a  pile  of  meat,  a  whole  lotta  bread,  and  more  condiments 
than  you  can  shake  a  stick  at.  But  what  he  doesn’t  have  is  a  menu!  Can 
you  build  a  program  that  makes  a  new  random  menu  for  him  every  day? 


Start  a  new  project  and  add  a  MenuMaker  class 

If  you  need  to  build  a  menu,  you  need  ingredients.  And  arrays  would  be  perfect 
for  those  lists.  We’ll  also  need  some  way  of  choosing  random  ingredients  to 
combine  together  into  a  sandwich.  Luckily,  the  .NET  Framework  has  a  built-in 
class  called  Random  that  generates  random  numbers.  So  we’ll  have  four  fields 
in  our  class:  a  Randomizer  field  that  holds  a  reference  to  a  Random  object,  and 
three  arrays  of  strings  to  hold  the  meats,  condiments,  and  breads. 


MenuMaker 


Randomizer 

Meats 

Condiments 

Breads 


GetMenultem() 


The  -field  called 

Randomizer  holds 
a  reference  to  a 
Random  object 
Calling  its  Ne*tO 
method  will 

generate  random 
numbers 


public  class  MenuMaker  ( 

public  Random  Randomizer; 


string [] 
stringf] 


Meats  = 


The  class  has  three  fields  to 
store  three  different  arrays  of 
f  strings.  It’ll  use  them  to  build 
y y  the  random  menu  items. 

"Salami",  "Turkey",  "Ham",  "Pastrami"  }; 


{  "Roast  beef". 

Condiments  =  {  "yellow  mustard",  "brown  mustard", 

"honey  mustard",  "mayo",  "relish",  "french  dressing"  }; 

stringf]  Breads  =  {  "rye",  "white",  "wheat",  "pumpernickel", 

"italian  bread",  "a  roll"  };  Remember,  use  square  brackets  to 

Sc  access  a  member  of  an  array  The 
^  '  value  of  BreadsfZJ  is  "wheat” 


Add  a  GetMenltemO  method  to  generate  a  random  sandwich  to  the  class 

The  point  of  the  class  is  to  generate  sandwiches,  so  let’s  add  a  method  to  do  exactly  that.  It’ll 
use  the  Random  object’s  Next  ( )  method  to  choose  a  random  meat,  condiment  and  bread 
from  each  array.  When  you  pass  an  int  parameter  to  Next  ( ) ,  the  method  returns  a  random 
that’s  less  than  that  parameter.  So  if  your  Random  object  is  called  Randomizer,  then  calling 
Randomizer .  Next  ( 7 )  will  return  a  random  number  between  0  and  6. 

So  how  do  you  know  what  parameter  to  pass  into  the  Next  ( )  method?  Well,  that’s  easy  just 
pass  in  each  array’s  Length.  That  will  return  the  index  of  a  random  item  in  the  array. 


The  £jetMenu|temO 
method  returns 
a  string  that 
Contains  a  sandwich 
built  from  random 
elements  in  the 
three  arrays 


public  string  GetMenuItemf )  { 

string  randomMeat  =  Meats [Randomizer. Next (Meats. Length) ] ; 
string  randomCondiment  =  Condiments [Randomizer .Next (Condiments. Length) ] ; 
string  randomBread  =  Breads [Randomizer .Next (Breads .Length) ] ; 
return  randomMeat  +  "  with  "  +  randomCondiment  +  ”  on  "  +  randomBread; 


1 


/  The  method  puts  a  random  item  from  the  Meats  array  into  random/VJeat  by 
\_  passing  Meats  Length  to  the  Random  object’s  Next^  method  Since  there  are  5 
items  in  the  Meats  array,  Meats  Length  is  *5,  SO  Ne*t(5)  will  return  a  random 
number  between  0  and  T- 
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[lo\\  if  Wop[cS... 


xCxK7)  "'etKod  leii  >  «-»w  that's 

/VlMts  So  randomizer .  Next  (Meats .  Length)  oives 
D  |  ra\r  r  er  ******  V*»  or  e*2  Wo, 

t  less  than  the  number  of  elements  in  the  Meats  array. 


Meats [Randomizer . Next (Meats . Length) ] 

1^  Me>u  »  a-  *«7  •*  lts  51*” 

“Roast  Beefw,  and  Mea tsB3  equals  Ha-  • 


Build  your  form 

Add  six  labels  to  the  form,  labell  through  lablelS.  Then  add  code  to  set  each  label’s 
Text  property  using  a  MenuMaker  object.  You’ll  need  to  initialize  the  object  using  a  new 
instance  of  the  Random  class.  Here’s  lire  code: 


public  Forml  ()  { 

Init ializeComponent  () ; 


Use  an  object  initializer  to  set  the 
MenuMaker  objects  Randomizer  field  to 
a  new  instance  of  the  Random  class. 


MenuMaker  menu  =  new  MenuMaker ()  {  Randomizer  =  new  Random ()  }; 


labell.  Text  =  menu.GetMenuItemO 
label2.Text  =  menu.GetMenuItemO 
label3.Text  =  menu.GetMenuItemO 
label4.Text  =  menu.GetMenuItemO 
label5.Text  =  menu.GetMenuItemO 
label6.Text  =  menu.GetMenuItemO 


Now  you’re  all  set  to 
generate  sin  different 
random  sandwiches  usin^  the 
i^etMenultemO  method 


VVhen  you  run  the 
yroyri m,  the  sin  labels 
show  sin  different 
random  sandwiches. 


Sloppy  Joe's  Menu 


Roast  beef  with  honey  mustard  on  wheat 

Turkey  with  mayo  on  Italian  bread 

Ham  with  relish  on  white 

Pastrami  with  yellow  mustard  on  rye 

Turkey  with  mayo  on  rye 

Roast  beef  with  brown  mustard  on  white 


□ 
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your  object’s  a  chatty  cathy 


Objects  use  references  to  talk  to  each  other 


So  far,  you've  seen  forms  talk  to  objects  by  using  reference  variables  to  call  their 
methods  and  check  their  fields.  Objects  can  also  call  each  others’  methods  using 
references,  too.  In  fact,  there’s  nothing  that  a  form  can  do  that  your  objects  can’t  do, 
because  your  form  is  just  another  object.  And  when  objects  talk  to  each  oilier, 
one  useful  keyword  that  they  have  is  this.  Any  time  an  object  uses  the  this  keyword, 
it’s  referring  to  itself  it’s  a  reference  that  points  to  the  object  that  calls  it. 


Here's  a  method  to  tell  an  elephant  to  speak 

Let’s  add  a  method  to  the  Elephant  class.  Its  first  method  is  a  message  front  an  elephant.  Its 
second  method  is  the  elephant  that  said  it: 

public  void  TellMe (string  message.  Elephant  whoSaidlt)  { 

MessageBox. Show (whoSaidlt .Name  +  "  says:  "  +  message); 

I 


Here’s  what  it  looks  like  when  it’s  called: 

Elephant  lloyd  =  new  Elephant ()  {  Name  =  "Lloyd",  EarSize  =40  }; 
Elephant  lucinda  =  new  Elephant!)  1  Name  =  "Lucinda",  EarSize  =  33  ) ; 
lloyd. TellMe ("Hi",  lucinda); 


We  called  I  Joyd’s  TellMe()  method,  and  passed  it  two  parameters:  “Hi"  and  a  reference  to 
Lucinda’s  object.  The  method  uses  its  whoSaidlt  parameter  to  access  the  Name  parameter  of 
whatever  elephant  was  passed  into  TellMeO  using  its  second  parameter. 

Here's  a  method  that  calls  another  method 

Now  let’s  this  SpeakTo()  method  to  the  Elephant  class.  It  uses  a  special  keyword:  this.  That’s 
a  reference  that  lets  an  object  talk  about  itself. 

public  void  SpeakTo (Elephant  talkTo,  string  message)  { 

talkTo .TellMe  taessage.  this) ;  ^  E|£pka„t  £lass  £ills 

*  elephants  TalkToO  method  It  lets  one  elephant 

Let’s  take  a  closer  look  at  how  this  works.  Communicate  wth  another  one 


lucinda . SpeakTo (lloyd,  "Hello") ; 


When  Lucinda’s  SpeakTof)  method  is  called,  it  uses  its  talkTo  reference  parameter  to  call 
Lloyd’s  TellMeO  method. 


talkTo. TellMe (message,  this); 

Lucinda  uses  talkTo  \this  is  replaced 
(which  has  a  reference  to  \with  a  reference  to 
Lloyd)  to  call  TellMeO  \Lucinda’s  object 

lloyd. TellMe (message,  [a  reference  to  Lucinda]) ; 

So  Lloyd  acts  as  if  he  was  called  with  (“Hello”,  lucinda),  and  shows  this  message: 
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Where  no  object  has  gone  before 


There’s  another  important  keyword  that  you’ll  use  with  objects. 

When  you  create  a  new  reference  and  don’t  set  it  to  anything,  it  has 

a  value.  It  starts  off  set  to  null,  which  means  it’s  not  pointing  to 

anything.  D.  .  ,  , 

_ _  now,  'there  s  only 

Dog  f ido ;  objcdt  TKf  f,do 

ee+erenee  is  set  to  null. 

Dog  lucky  =  new  Dog ( ) ; 


fido  =  new  Dog(); 


Now  that  -fido’s  pointing 
to  an  object,  its  no 
longer  e<\ual  to  null 


f 

lucky  =  null; 


When  we  set  lucky  to  null, 
it’s  no  longer  pointing  at  its 
object,  so  it  gets  garbage  v 
Collected 


tliere.are  no 

Dumb  Questions 


/ 

poof! «- 

/  \  \ 


;  One  more  time — my  form  is  an 
object? 

^  Yes!  That's  why  your  class  code  starts 
with  a  class  declaration.  Open  up  code  for 
a  form  and  see  for  yourself  Then  open  up 
Program.es  in  any  program  you've  written  so 
far  and  look  inside  the  InitializeComponentf) 
method— you'll  find  ‘new  Forml  ( ) 

Qj  Why  would  I  ever  use  null? 

There  are  a  few  ways  you  see  null 
used  in  typical  programs.  The  most  common 
way  is  testing  for  it: 


if  (lloyd  ==  null)  { 

That  test  will  return  true  if  the  lloyd 
reference  is  set  to  null. 

Another  way  you'll  see  the  null  keyword 
used  is  when  you  want  your  object  to  get 
garbage  collected.  If  you've  got  a  reference 
to  an  object  and  you’re  finished  with  the 
object,  setting  the  reference  to  null  will 
immediately  mark  it  for  collection  (unless 
there's  another  reference  ot  it  somewhere.) 

Qj  You  keep  talking  about  garbage 
collecting,  but  what’s  actually  doing  the 
collecting? 


,/\j  Remember  how  we  talked  about  the 
Common  Language  Runtime  (orCLR) 
back  in  the  beginning  of  the  first  chapter? 
That's  the  virtual  machine  that  runs  all  NET 
programs.  A  virtual  machine  is  a  way  for  to 
isolate  running  programs  from  the  rest  of 
the  operating  system.  One  thing  that  virtual 
machines  do  is  manage  the  memory  that 
they  use.  That  means  that  it  keeps  track  of 
all  of  your  objects,  figures  out  when  the  last 
reference  to  the  object  disappears,  and  frees 
up  the  memory  that  it  was  using 
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this  and  that 


there  ictfe  no 

Dumb  Questions 


V;  I’m  still  not  sure  I  get  how 
references  work. 

y\’  References  are  the  way  you  use  all 
of  the  methods  and  fields  in  an  object.  If 
you  create  a  reference  to  a  Dog  object  you 
can  then  use  that  reference  to  access  any 
methods  you've  created  for  the  Dog  object. 

If  you  have  (non-static)  a  method  called 
Dog  Bark()  or  Dog  Beg().  you  can  create 
a  reference  called  spot.  Then  you  can  use 
that  to  access  spot  Bark()  or  spot,Beg().  You 
could  also  change  information  in  the  fields 
for  the  object  using  the  reference,  So  you 
could  change  a  Breed  field  using  spot.Breed. 

O:  Wait,  then  doesn’t  that  mean  that 
every  time  a  change  a  value  through  a 
reference  I'm  changing  it  for  all  of  the 
other  references  to  that  object  too? 

Yes  If  rover  is  a  reference  to  the 
same  object  as  spot,  changing  rover  Breed 
to  "beagle'  would  make  it  so  that  spot.Breed 
was  “beagle." 


O !  Go  back  to  that  stuff  about  value 
types.  Now,  why  can't  I  change  a  small 
number  from  a  bigger  type  if  it’s  small 
enough? 

Okay  The  thing  about  variables  is  they 
assign  a  size  to  your  number  no  matter  how 
big  its  value  is.  So  if  you  name  a  variable 
and  give  it  a  long  type  even  though  the 
number  is  really  small,  (like,  say,  5)  C#  sets 
aside  enough  memory  for  it  to  get  really  big. 
When  you  think  about  it,  that’s  really  useful. 
After  all,  they’re  called  variables  because 
they  change  all  the  time. 

C#  assumes  you  know  what  you're  doing 
and  you’re  not  going  to  give  a  vanable  a 
type  that  you  don't  need.  So  even  though 
the  number  might  not  be  big  now,  there’s  a 
chance  that  after  some  math  happens,  it’ll 
change  and  C#  gives  it  enough  memory  to 
handle  whatever  type  of  number  you  call  it. 

Qj  Remind  me  again— what  does 

“this.”  do? 


this  is  a  special  vanable  that  you 
can  only  use  inside  an  object.  When  you’re 
inside  a  class,  you  use  this  to  refer  to  any 
field  or  method  of  that  particular  instance. 

It’s  especially  useful  when  you're  working 
with  an  class  whose  methods  call  other 
classes  One  object  can  use  it  to  send  a 
reference  to  itself  to  another  object.  So  if 
Spot  calls  one  of  Rover’s  methods  passing 
this  as  a  parameter,  he’s  giving  Rover  a 
reference  to  the  Spot  object 

An y  time  you’ve  got 
code  in  an  object 
that’s  going  to  be 
instantiated,  tbe 
instance  can  use  tbe 
special  this  variable 
that  bas  a  relerence 
to  itsell. 


BULLET  POINTS 


■  There  are  value  types  for  numbers  that  hold  different 
sizes  of  numbers.  The  biggest  numbers  should  be  of  the 
type,  long  and  the  smallest  ones  (up  to  128)  can  be 
declared  as  bytes. 

■  When  you  declare  a  variable  you  ALWAYS  give  a  type. 
Sometimes  you  combine  it  with  setting  the  value. 

■  Every  value  type  has  a  size,  and  you  can’t  put  a  value  of 
a  bigger  type  into  a  smaller  variable,  no  matter  what  the 
actual  size  of  the  data  is. 


The  compiler  won’t  let  you  set  a  variable  equal  to  a 
value  of  a  different  type  unless  you  cast  it. 

There  are  some  words  that  are  reserved  by  the 
language  and  you  can’t  name  your  variables  with  them. 
They're  words  like,  for,  while,  using,  new,  and 
others  that  do  specific  things  in  the  language. 

References  are  like  labels  you  can  have  as  many 
references  to  an  object  as  you  want  and  they  all  refer  to 
the  same  thing. 


■  When  you’re  using  literal  values,  use  the  F  suffix  to 
indicate  a  float  (15.6F)  and  M  for  a  decimal  (36.12M). 


If  an  object  doesn't  have  a  reference,  it  gets  garbage 
collected. 
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Sharpen  your  pencil 
W 


Here's  an  array  of  Elephant  objects  and  a  loop  that  will  go  through 
it  and  find  the  one  with  the  biggest  ears.  What's  the  value  of  the 
biggestEars.Ears  after  each  iteration  of  the  for  loop? 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


{ 


Elephant []  elephants  =  new  Elephant [7) 


We’re  dreatmg  a«  array  o(  1 
El  ephantO  references. 


elephants [0] 

= 

new 

Elephant () 

( 

Name 

= 

"Lloyd", 

EarSize  = 

40 

1; 

elephants [1] 

= 

new 

Elephant ( ) 

{ 

Name 

= 

"Lucinda 

",  EarSize 

= 

33  }; 

elephants [21 

a 

new 

Elephant ( ) 

( 

Name 

= 

"Larry", 

EarSize  = 

42 

1; 

elephants [3] 

= 

new 

Elephant () 

{ 

Name 

= 

"Lucille 

",  EarSize 

= 

32  ); 

elephants [41 

= 

new 

Elephant ( ) 

{ 

Name 

= 

"Lars", 

EarSize  = 

44 

>; 

elephants [51 

= 

new 

Elephant ( ) 

{ 

Name 

= 

"Linda", 

EarSize  = 

37 

}; 

elephants [61 

= 

new 

Elephant () 

( 

Name 

= 

"Humphrey",  EarSize  = 

45  }; 

Every  array 
starts  with 

mde*  0,  so  the 
first  elephant 
in  the  array  is 
ElephantsCOJ 


J 

Iteration  #1  biggestEars.Earssize  = 


Elephant  biggestEars  =  elephants [0] ; 
for  (int  i  =  1;  i  <  elephants. Length;  i++) 


Iteration  #2  biggestEars.EarSize  = 
if  (elephants [i] .EarSize  >  biggestEars.EarSize) 


Iteration  #3  biggestEars.EarSize  = 


( 

biggestEars  =  elephants [i] ; 

)  This  line  makes  the  biggestEars 

re-ferende  point  at  whatever 
M  elephant  elephantsfiJ  points  to. 

MessageBox.Show  (biggestEars. EarSi ze. ToString  () )  'jtera(jon  #4  biggestEars  EarSize  = 


Be  dare-ful— this  loop  starts 
with  the  sedond  element  o(  the 
array  (at  inde*  I)  and  iterates 
si*  times  until  i  is  egual  to  the 
length  of  the  array 


Iteration  #5  biggestEars.EarSize  = 


Iteration  #6  biggestEars.EarSize  = 


you  are  here  ► 
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Sharpen  your  pencil 
v  Solution 


Here's  an  array  of  Elephant  objects  and  a  loop  that  will  go  through 
it  and  find  the  one  with  the  biggest  ears.  What's  the  value  of  the 
biggestEars.Ears  after  each  iteration  of  the  for  loop? 


private  void  buttonl_Click (object  sender,  EventArgs  e) 


{ 


D;  A  v/ou  rCr*tr*' 

°  7  .  I.  the 

the  loo?  sta^ 

elephants  [0]  =  new  Elephant  ()  (  Name  =  "Lloyd",  EarSize  =  40  };  setowi  element  or  t 

Whv  do  you  think 

elephants[l]  =  new  Elephant()  {  Name  =  "Lucinda",  EarSize  =  33  };  ®r'r-7’  ' 

that«? 

elephants [2]  =  new  Elephant ()  {  Name  =  "Larry",  EarSize  =42  }; 

elephants [3]  =  new  Elephant ()  (  Name  =  "Lucille",  EarSize  =32  }; 

elephants[4]  =  new  Elephant ()  {  Name  =  "Lars",  EarSize  =  44  }; 

elephants [5]  =  new  Elephant ()  {  Name  =  "Linda",  EarSize  =37  }; 

elephants [6]  =  new  Elephant ()  {  Name  =  "Humphrey",  EarSize  =  45  } ? 


her  that 


Elephant  biggestEars  =  elephants [0] ; 
for  (int  i  =  1;  i  <  elephants. Length;  i++) 


Iteration  #1  b  iggcst Ears.  Earssize 


•  _  4 0 

17.C  —  1 


( 


Iteration  #2  biggestEars. EarSize 


rSize  =  42- 


if  (elephants [i] .EarSize  >  hjLggestEars . EarSize) 


{  (^The  biggestEars 

.  tCfarhCr  is  used  to  keep 

biggestEars  -  elephants  U 1  ^  ^  L„inn  m  hiro„,p^FjrSi7,  =  \X 

)  we  ve  seen  while  gomg 

through  the  for  loo?  has 
the  biggest  ears  so  -far 


MessageBox. Show (biggestEars. EarSize. ToString () ) ; 


Iteration  #4  biggestEars. EarSize 


_  44 

size  =  I  I 


The  for  loo?  starts  with  the  second  elephant 
and  compares  it  to  whatever  elephant 
biggestEars  points  to  1-f  its  ears  are 
bigger,  it  points  biggestEars  at  that 
elephant  instead  Then  it  moves  to  the  next 
one,  then  the  next  one...  by  the  end  o£  the  loo? 
biggestEars  points  to  the  one  with  the 
biggest  ears 


Iteration  #5  biggestEars. EarSize 


=  4-4- 


Iteration  #6  biggestEars. EarSize  = 


4*5 
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Code  Magnets 


The  code  for  a  button  is  all  scrambled  up  on  the  fridge.  Can  you 
reconstruct  the  code  snippets  to  make  a  working  method  that 
produces  the  output  listed  below? 


int  Y 


islands 

Viands 


refNum  -  indexfy]; 


BermUda" • 


"Fiji-. 


- - lfl  -  ■'  JJ  =  «r 


int  refNum; 


while  (y  <  4)  { 


:umel" • 


result  +=  islands [refNum] ; 


MessageBox . Show (result) ; 


r~~ 

index  til  -  3;  I  'l 

1  index  [2]  -  0;  lT^ 


□ 


index 


[3]  -  2 i 


String]]  islands  *  new  String[4]; 

result  4=  "\nisland  =  " t  1 


lntn  index  T 


new  int  [41; 


island  =  Fij 
Island  =  Cozumel 
island  =  Bermuda 
Island  =  Azores 


y  =  y  +  l; 


?riVate  Void  C>uttonl_C!ick  (object 


sender,  EventArgs  e) 


exercise  solutions 


Code  Magnets  Solution 

The  code  for  a  button  is  all  scrambled  up  on  the  fridge.  Can  you 
reconstruct  the  code  snippets  to  make  a  working  method  that 
produces  the  output  listed  below? 


here's  where  O'* 

index  U  arraY 

yts  initialised 


^is  while  loop  pu|| 
a  value  -(row. 
index  [J  array 
uses  ,{  4r 
the  index  in  tke 
islands  []  array. 


String  [4]; 


The  islands  []  array 
is  initialized  here 


The  result  string  ’s,UJt 
uy  usm9  the  +=  oferaW  to 
Concatenate  lines  onto  *t 


refNum  =  index  [y]; 

result  +m  "\nisland  =  | 

island  =  Fij 
island  =  Cozumel 
island  =  Bermuda 
island  =  Azores 

result  +=  islands  [refNuml^^J 

1 

i 

• 

— *  I 

OK 

□ 


o 

^ssageBo^how(^sult)J 
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Pool  ?u^z]e 

Your  job  is  to  take  code  snippets 
from  the  pool  and  place  them 
into  the  blank  lines  in  the 
code.  You  may  use  the  same 
snippet  more  than  once,  and 
you  won't  need  to  use  all  the 
snippets.  Your  goal  is  to  make 
a  class  that  will  compile  and  run 
and  produce  the  output  listed. 


Output 


triangle  0,  area  =  4 
triangle  1,  area  =  10 
triangle  2,  area  =  18 
triangle  3,  area= 

y  = 


Bonus  Question! 

For  extra  bonus  points,  use  snippets 
from  the  pool  to  fill  in  the  two  blanks 
missing  from  the  output. 


Note:  Each  snippet  from 
the  pool  can  be  used 
more  than  once 


types  and  references 

Hcrt's  tV*  ejbnf  ^st'a  We 

aoo\«tat'on  A**,  X  the  to? 

double  area;  f  ^  "W*  W  ^ 

int  height;  [  ^  7 

int  length;  uk 

public  static  void  Main (String [1  args) 

{ 

string  results  =  ""; 


class  Triangle 

I 


while  ( 
( 


.height  =  (x  +  1)  *  2; 
.length  =  x  +  4; 


results  +=  "triangle  "  +  x  +  ",  area"; 
results  +=  ”  =  "  +  .area  +  "\n"; 


} 


x  =  27; 

Triangle  t5  =  ta[2]; 
ta [2] .area  =  343; 
results  +=  ”y  «  "  +  y; 
MessageBox. Show (results  + 

",  t5  area  =  "  +  t5.area) 
J 

void  setArea ( ) 

{ 


ttint:  SetA reaO 
it  HOT  a 
static  method 
Bp  tack  to 
Chapter  Z  tor 
a  refresher  on 

what  the  static 

keyword  means. 


=  (height  *  length)  /  2; 
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lifter  this 
„*'ve  got  3n  array 
of  four  Triage 

referentes— but 

there  aren’t  any  ~— 
Tnan^e  objects  yet 


Bonus  Answer 


ajafiort 


r 


class  Triangle 
{ 


Notide  box  this  dlass  don-tains 
the  entry  point,  but  it  also 
dreates  an  instande  of  itself? 
That's  dompletely  legal  in  C# 


double  area; 
int  height; 
int  length; 
public  static  void  Main (String []  args) 
( 


string  results  = 


int  x  —  O', 

Trian^leH  ta  —  nex  Trian<^leffi3; 

while  (  x  <  ^~  ) 


The  xhile  loop 
dreates  the  tour 
instandes  of 


{ 


tafx3  —  nex  TriangleO; _ 

ta£x3  .height  =  (x  +  1)  *2; 
ta£x3  .length  =  x  +  4; 
tatx3  set  AreaO; _ 

results  +=  "triangle  "  +  x  + 
results  +=  "  =  "  +  tatx3  .area 
x  —  x  \  I; 


Triangle  by  railing 
the  nex  statement 
•four  times. 


,  area"; 
+  ”\n"; 


} 

int  y  —  X, 

x  =  27; 

Triangle  t5  =  ta[2]; 
ta[2].area  =  343; 
results  +=  "y  =  "  +  y; 
MessageBox. Show (results  + 

",  t5  area  =  "  +  t5.area); 


The  Set/WeaO  method 
uses  the  height  and 
length  f  ields  to  set  the 
area  field-  Sinde  it’s  not 


a  statid  method,  it  dan 
only  be  tailed  from  inside 
an  instande  of  Triangle 


} 

void  setAreaO 
( 

area _ 

> 


(height  *  length)  /  2; 
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namespace 


for 


class 


public 


else 


new 


using 


if 


while 


There  are  about  77  reserved  words  in  C#.  These  are  words  reserved  by  the  C#  compiler;  you 
can’t  use  them  for  variable  names  You'll  know  them  all  really  well  by  the  time  you  finish  the  book. 
Here  are  some  you've  already  used.  Write  down  what  you  think  these  words  do  in  C#. 


Name spades  make  sure  that  ike  names  you  are  usino  in  your  p» -oar am  don't  Collide 

with  ike  ones  in  ike  -NET  Framework  or  other  external  classes  You’ve  used  in  your 

program  All  of  ike  classes  and  methods  in  a  program  are  inside  a  namespace 

This  lets  you  do  a  loop  tkat  executes  three  statements  First  it  declares  ike 

variable  it’s  AoinA  to  use,  tken  tkere’s  tke  statement  tkat  evaluates  tke  variable 

against  a  Condition.  Tke  third  statement  does  something  to  tke  value- 

A  class  is  how  you  detine  an  object  Classes  kave  properties  and  metkods 

Properties  are  what  tkey  know  and  metkods  are  what  tkey  do 

A  public  class  can  be  used  bY  everY  otker  class  in  tke  project-  When  a  variable  or 

method  is  declared  as  public,  it  can  be  used  bY  classes  and  called  bY  methods  that  are 

outside  ot  the  one  it's  bein^  declared  in. 

Code  tkat  starts  with  else  will  «t  executed  if  tke  if  statement  precedmo  it  fails. 

You  use  this  to  create  a  new  instance  o£^n_obiect_ 

This  is  a  waY  of  listing  off  all  of  tke  namespaces  You  are  usin«\  in  Your  program.  Usme^ 

lets  you  use  Code  from  tke  NfcT  framework  and  pre— defined  classes  from  third  parties 

as  well  as  classes  you  can  make  yourself 

One  waY  of  setting  up  a  conditional  statement  in  a  program  |t  says 

f  one  thinoj  is  true,  do  one  tkm<^  and  if  not  do  something  else 

while  loops  are  loops  tkat  keep  on  qoinct  as  lonc\  as  tke  Condition  in  them  is  true- 

you  are  here  ► 
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1 62  Chapter  4 


A  Day  at  the  Races 

This  lab  gives  you  a  spec  that  describes  a  program 
for  you  to  build,  using  the  knowledge  you’ve  gained 
over  the  last  few  chapters. 

This  project  is  bigger  than  the  ones  you’ve  seen  so  far. 
So  read  the  whole  thing  before  you  get  started,  and 
give  yourself  a  little  time.  And  don’t  worry  if  you  get 
stuck— there’s  nothing  new  in  here,  so  you  can  move 
on  in  the  book  and  come  back  to  the  lab  later. 

We’ve  filled  in  a  few  design  details  for  you,  and  we’ve 
made  sure  you’ve  got  all  the  pieces  you  need...  and 
nothing  else. 

It’s  up  to  you  to  finish  the  job.  You  can  download 
an  executable  for  this  lab  from  the  website...  but  we 
won’t  give  you  the  code  for  the  answer. 


C#  Lab  1 63 


A  Day  at  the  Races 


The  Spec:  Puild  a  Racetrack  Simulator 

Joe,  Boh,  and  A1  love  going  to  the  track,  blit  they’re 
tired  of  losing  all  their  money.  They  need  you  to  build  a 
simulator  for  them  so  they  can  figure  out  winners  before 
they  lay  their  money  down.  And,  if  you  do  a  good  job, 
they’ll  cut  you  in  on  their  profits. 

Here’s  what  you’re  going  to  build  for  them... 


The  Guys 

Joe.  Bob,  and  A1  want  to  bet  on  a  dog  race.  Joe  starts  with  50  bucks 
Bob  starts  with  75  bucks,  and  A1  starts  with  45  bucks.  Before 
each  race,  they’ll  each  decide  if  they  want  to  bet,  and  how 
much  they  want  to  put  down.  The  guys  can  change  their  bets 
right  up  to  the  start  of  the  race...  but  once  the  race  starts,  all 
bets  are  final.  ■ 


rrw\ 


The  Petting  Parlor 

The  betting  parlor  keeps  track  of  how  much  cash  each 
guy  has,  and  what  bet  he’s  placed.  There’s  a  minimum 
bet  of  5  bucks.  The  parlor  only  takes  one  bet  per  person 
for  any  one  race. 


Fhe  parlor  checks  to  make 
sure  that  the  guy  who’s  betting 
has  enough  cash  to  cover  his 
bet  so  the  guys  can’t  place  a 
bet  if  they  don’t  have  the  cash 
to  cover  the  bet. 


Welcome  to  Curly's 
Betting  Parlor 

Minimum  B«t  IS 

On*  btt  at  •  t«w 

Got  toMigh  cart  7 


Welcome  to  Curly’s 
Betting  Parlor 

Minimum  Bet:  $5 
One  bet  per  person  per  race 
Got  enough  cash? 
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Petting 

Even1  bet  is  double-or-nothing- — either  the  winner  doubles 
liis  money,  or  he  loses  what  he  bet.  There's  a  minimum 
bet  of  5  bucks,  and  each  guy  can  bet  up  to  15  bucks  on  a 
single  dog.  If  the  dog  wins,  the  bettor  ends  up  w  ith  twice 
the  amount  that  he  bets  (after  the  race  is  complete).  If  he 
loses,  that  amount  disappears  from  his  pile.  ^ 

Say  a  of, y  plates  a  /lO  bet  at  the  window.  At 
the  end  of  the  rate,  if  his  dog  wins,  his  tash  y 
5©es  up  by  f  10  (betause  he  keeps  the  original  flO 
he  bet,  plus  he  gets  jl 0  more  fro™  winning)-  If 
he  loses,  his  tash  goes  down  by  }I0. 

The  Race 

There  are  four  dogs  that  run  on  a  straight  track.  The 
winner  of  the  race  is  the  first  dog  to  cross  the  finish  line.  4 
Tile  race  is  totally  random,  there  are  no  handicaps  or 
odds,  and  a  dog  isn't  more  likely  to  win  his  next  race 
based  on  his  past  performance. 


■  !ir  u<j  ^ 

2  5,1  "'««  do  ai  it'ii 

bf  9°°d  pratt.ee  wr.t.nq 
some  run  Code  3 


Sound  fun?  We’ve  got  more  details  coming  up... 
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You'll  need  three  classes  and  a  form 

You'll  build  (hire  main  classes  in  the  project,  as  well  as  a  GUI  lor  the 
simulator.  You  should  have  an  array  of  three  Guy  objects  to  keep  track 
of  the  three  guys  and  their  winnings,  and  an  array  of  four  Greyhound 
objects  that  actually  run  die  race.  Also,  each  instance  of  Guy  should 
have  its  own  Bet  object  that  keeps  track  of  his  bet  and  pays  out  (or 
takes  back)  rash  at  the  end  of  the  race. 

We’ve  gotten  you  started  with  class  descriptions  and  some  snippets  of 
code  to  work  from.  You’ve  got  to  finish  everything  up. 


You’ll  need  to  add  “using 
System. Windows.Forms”  to 
the  top  of  the  Greyhound  and 
Guy  classes. 


We've  given  you  the  skeleton  of 
the  class  voii  need  to  build  '/out 
job  is  to  fill  in  the  methods. 


/ 


Greyhound 


StartingLocation 

RacetrackLength 

MyPictureBox 

Location 

MyRandom 


Run() 

TakeStartingPositionO 


See  ho*  the  class  diagram 
matches  up  *'th  the  tode. 


public  class  Greyhound  ( 

public  int  StartingPosition;  //  Where  my  PictureBox  starts 
public  int  RacetrackLength;  //  How  long  the  racetrack  is 
public  PictureBox  MyPictureBox  null;  //  My  PictureBox  object 
public  int  Location  =  0;  //  My  Location  on  the  racetrack 
public  Random  MyRandom;  //  An  instance  of  Random 

public  bool  Run()  ( 

//  Move  forward  either  1,  2,  3  or  4  spaces  at  random 
/ /  Update  the  position  of  my  PictureBox  on  the  form 
II  Return  true  if  I  won  the  race 

}  ^  We  ve  added  Comment  to  gjve 

you  an  idea  of  what  A  ° 
public  void  TakeStartingPositionO  ( 

II  Reset  my  location  to  the  start  line 


1 

1 

* 


T 


The  greyhound  object  initialize  is  pretty 
straightforward  Just  make  sure  you  pass  a 
reference  to  the  right  PittureBox  on  the 
form  to  each  greyhound  object 

Your  object  can  control  things  on  your  form... 


^Pon’t  overth-rk  ^ 

sometimes  you  just  reea 

a  variable,  and  you  re  done. 


s —  You  II  have  to  make  sure 
f^^m  passes  the 


The  Greyhound  class  keeps  track  of  its  position  on  the  racetrack  during  the  race.  It  also  f'Sht  picturebox  into 

updates  the  location  of  the  PictureBox  representing  the  dog  to  move  down  the  race  e*th  greyhound's  object 

track.  Each  instance  of  Greyhound  uses  a  field  called  MyPictureBox  to  reference  initializer. 

llie  PictureBox  control  on  the  form  that  shows  the  picture  of  the  dog.  Suppose  the 

distance  variable  contains  the  distance  to  move  the  dog  forward.  Then  this  code  will 

update  the  location  of  MyPictureBox  by  adding  distance  to  its  X  value: 

Vou  <\et  the  Current 

Point  p  =  MyPictureBox. Location;^ - ?.  r  ^  picture 

p.X  +=  distance;  - - lota  “m 

MyPictureBox. Location  =  the  value  io  move  forward 

to  its  X  coordinate ... 


and  then  update  the  picture 
box  location  on  the  form. 
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public  class  Guy  ( 

public  string  Name;  //  The  guy's  name 

public  Bet  MyBet;  //  An  instance  of  Bet()  that  has  his  bet 
public  int  Cash;  //  How  much  cash  he  has 

//  The  last  two  fields  are  the  guy's  GUI  controls  on  the  form 
public  RadioButton  MyRadioButton;  //  My  RadioButton 
public  Label  MyLabel;  //My  Label 


//hen  y°u  mtializc  the 

6uv  obvefrt,  make  sure 
you  set  its  MyBet 
f  ield  to  null,  and 
tall  its  WydateLabelsO 
method  as  soon  as  its 

initialled 


This  is  the  objeet  that 
quv  uses  to  me  present 
bets  m  the  applitation. 


public  void  Update Labels ( )  { 

//  Set  my  label  to  my  bet's  description,  and 
//  my  radio  button  to  show  my  cash  ("Joe  has 

)  hdd  your  Code  here 

V 

public  void  ClearBetO  {  }  //  Reset  my  bet  so 


the  label  on  my 
43  bucks") 


it's  zero 

,  —  Remember  that  bets 

public  bool  PlaceBet(mt  Amount,  int  Dog)  {  e£  ,  ,  . 

//  Place  a  new  bet  and  store  it  in  my  bet  field  instances  of  B  + 

//  Return  true  if  the  guy  had  enough  money  to  bet  ^ 


public  void  Collect  (int  Winner) 


V 

t 


II  Ask  my  bet  to  pay  out 


/ 


The  bey  here  is  ^  Bet 

object  .  let  A  do  the  work 

The  object  initialiser  for  Bet  just 
f  ^  amount,  dog  and  bettor 


in  the  (\uy  code  6\uy  wild 
use  the  this  keyword  to 
pass  a  reference  to  himself 
to  the  Bet‘s  initializer. 


public  class  Bet  ( 

public  int  Amount;  //  The  amount  of  cash  that  was  bet 
public  int  Dog;  //  The  number  of  the  dog  the  bet  is  on 
public  Guy  Bettor;  //  The  guy  who  placed  the  bet 

public  string  GetDescription  ()  ( 

//  Return  a  string  that  says  who  placed  the  bet,  how  much 
//  cash  was  bet,  and  which  dog  he  bet  on  ("Joe  bets  8  on 
//  dog  #4") .  If  the  amount  is  zero,  no  bet  was  placed 
//  ("Joe  hasn't  placed  a  bet"). 

> 

public  int  PayOut (int  Winner)  ( 

//  The  parameter  is  the  winner  of  the  race.  If  the  dog  won, 

//  return  the  amount  bet.  Otherwise,  return  the  negative  of 
//  the  amount  bet.  ,  iask: 

)  ^Tbisisacommorprogrammmg^ 

)  assembly  a  stn^jrmcs^ 

several  individual  Wfc  ^  ^ 
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A  Day  at  the  Races 


168 


Here's  your  application  architecture 

Spend  some  time  looking  closely  at  the  architecture.  It 
looks  pretty  complicated  at  first,  but  there’s  nothing  here 
you  don’t  know.  Your  job  is  to  recreate  this  architecture 
yourself,  starting  with  the  Greyhound  and  Guy  arrays  in 
vour  main  form. 


Z  a  *t  ** 

greyhound  tl^ss. 


the  visual  objects  will  be 
tour  P.ctureBox  Controls  for 
the  pictures  of  the  doy  ybu'll 
pass  references  to  them  to  the 
object  initializers  of  the  four 
greyhound  objects.  It'll  also  have 
three  Rad. oButton  Controls  and 
three  labels,  which  you'll  pass  to 
the  object  initializers  of  the 
three  fcjuy  objects. 


Q 


The  form  needs  to  initialize 
both  of  these  arrays  when 
it  starts  up.  \ 


Olll 

Array  of  Greyhound  references 


^  guys  array  contains 

^  Wes  to  three  djuy 

Ws.  Each  of  those  7 

2“t*  has  a  field  called 

is  a  *We 
"  a  Bet  object 


A  Day  at  the  Races 


When  a  Guy  places  a  bet,  he 
creates  a  new  Get  object 

first  the  tow  tells  *2- 
to  plate  a  bet  tor  1  butb  or 

dog  #3- 

Guy [1] . PlaceBet  (7,  3) 


^  *Zl B%%Z\ia 

MyBet  =  new  Bet (7,  3,  this) 


true 


3nd  free  the  6uv  haW  . 

'“•**«  WPkiBHoS^gfc 

Eaeh  dog'  Ruh()  meho<j  ^ 

see  1+  that  dog  won  the  rate, 


The  form  tells  the  dogs  to  keep 
running  until  there's  a  winner 


//her  the  user 
tells  the  tow  to 
start  the  rate, 
the  tow  starts 
a  loop  to  animate 
eath  dog  running 
along  the  tratk 


The  Get  object  figures  out  if  it 
should  pay  out 


wins. 


the  loops  should  end  immediately  as 
soon  as  one  of  the  dog  .  '  7 

while  (  there’s  no  winner  )  { 

for  (  loop  through  each  dog,  making 
sure  there ’s  still  no  winner  )  ( 

have  the  dog  run  one  pace 

t 

} 


Guy[l] .Collect (winningDog) 


The  betting  parlor  in  the  tow  tells 

/eath  £?uy  whith  dog  won  so  he  tan 
tollett  any  winnings  from  his  bet 


MyBet . PayOut (winningDog) 


cjuy  will  add  the  result  o+  pet- 
PayoutO  to  his  task  So  if  the  dog  won, 
it  should  return  Amount;  otherwise,  it  II 
return  -  Amount 


i  f  (  my  dog  won  )  { 

return  Amount; 

)  else  { 

return  -Amount; 

) 
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Here's  what  your  (MJI  should  look  like 

The  graphical  user  interface  for  the  “Day  at  the  Races”  application 
consists  of  a  form  that’s  divided  into  two  sections.  The  top  is  the 
racetrack:  a  PictureBox  control  for  the  track,  and  four  more  for 
the  dogs.  The  bottom  half  of  the  form  shows  the  betting  parlor,  where 
three  guys  (Joe,  Bob,  and  Al)  can  bet  on  the  outcome  of  the  race. 

of  the  W 

you  mitialw*  Z$Lt*U  to  ore  df  these  objects- 

MyPicturebo*  ^  the  racetrack  length  3rd 


/ou]l  use  the  Length  property 

»+  the  racetrack  PictureBox 
Control  to  set  the  racetrack 
length  in  the  greyhound  object, 
f  Ch  it’ll  use  to  4 re  J? 
it  won  the  race.  . 


Betting  Parlor 

Minimum  bet  ,or"'  shCT*ld  update  this 
^  "tel  with  the  minimum  bet 

'  \  \ _ -  using  the  Minimum  property 

O  Bob)  of  the  NumencUpDown 

VO  Al/  Control  for  the  bet  amount. 


M  ^^y^ar^e^T 

the  race,  but  there’s  only 
one  betting  window  so 
only  one  guy  can  place  a 
bet  at  a  time.  These  radio 
buttons  are  used  to  select 
which  guy  places  the  bet. 


I  Joe's  bet 
Bob's  bet 
lAI's  bet 


bucks  on  dog  number  1 


When  a  $uy  places  a  bet  it  overwrites 
any  previous  bet  he  placed  The  Current 
bets  show  up  in  these  label  Controls 
Each  lablel  has  Auto£.w  set  to  False 
and  BorderStyle  set  to  F ixedSmgle 


.  Once  all  bets  are 
placed,  click  this 
button  to  start 
the  race 


ou  can  download  ihe  graphics  files  from  vwv.headfirstlalis.com/l>ooks/lifcsliarp/ 
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Placing  bets 

Use  the  controls  in  the  Betting  Parlor  groupbox  to  place 
each  guy’s  hel.  There  are  three  distinct  stages  here: 

Q  No  bets  have  been  placed  yet 

When  the  program  first  starts  up,  or  if  a  race  has  just  finished,  no  bets 
have  been  placed  in  the  belting  parlor.  You'll  see  each  guy’s  total  cash 
next  to  his  name  on  the  left. 


We*  a  g„y  p/ateJ  a  bei 

label  us  °  "this 


£aeh  Yl‘*  tash 
shows  up  here-  — 


Minimum  bet:(5jbucks  TV  mini*****  bet  Bets 
®  Joe  has  50  bucks  should  be  the  sa»»e  I  Joe  hasn't  placed  < 

Q  Bob  hak(75))ucks  ^he  imnimwn  value  |  Bob  hasn't  placed 

O  Al  has  45  bucks  f  m  ^et  C'or'^°l  |AI  hasnt  placed  a  I 


Bob  hasn't  placed  i 


Al  hasnt  placed  a  I 


Z  bucks  on  dog  number  [1 


Or£t  Bob  places 

Obis  bet,  his  6juy 

Each  guy  places  his  bets  object  updates  this 

To  place  a  bet,  select  the  guy’s  radio  button,  select  an  amount  and  a  dog,  and  click  |jbe| 

the  Bets  button.  His  PlaceBet  ( )  method  will  update  the  label  and  radio  button,  button  text  \ 


Minimum  bet:  5  bucks 

O  Joe  has  50  bucks 
®  Bob  has  75  bucks 
O  Al  has  45  bucks _ 


Bets 

I  Joe  bets  5  bucks  on  doq  #2~ 
^Bob  bets  13  bucks  on  doq~#3~ 
I  Al  bets  12  bucks  on  dog  #4 


Z  bucks  on  dog  number 


After  the  race,  each  guy  collects  his  winnings  (or  pays  up!) 

Once  the  race  is  complete  and  there’s  a  winner,  each  Guy  object  calls  his 
Collect  ( )  method  and  adds  his  winnings  or  losses  to  his  cash. 


Smte  A'  bet  12-  bucks 

on  the  wmn.h3 

cash  y*s  up  bY  2-  The 

other  two  W  '<«  tV,e 

mone^  the*/  bet 


171 


A  Day  at  the  Races 


The  Finished  Product 

You'll  know  your  “Day  at  the  Races”  application  is 
done  when  your  guys  can  place  their  bets  and  watch 
the  dogs  race. 


•  A  Day  at  the  Races 


puring  the  rate,  the  four 
images  run  across  the  racetrack 
untl  one  of  them  wins  the  race. 


Betting  Parlor 

Minimum  bet:  5  bucks 

o  Joe  has  50  bucks 
O  Bob  has  75  bucks 
(*)  Al  has  45  bucks 


Al  bets  1 2  bucks  on  dog  #4 


1 2  Z  bucks  on  dog  number  4 


You  can  download  a  finished  executable, 
as  well  as  the  graphics  files  for  the 
four  dogs  and  the  racetrack,  from  the 
Head  First  lahs  wehsite: 


During  the  rate,  no  bets  can  be 
placed  .  and  make  sure  you  ean’t 
start  a  new  race  while  the  dogs 

running 


But  you  won't  f  md  the  source  LoAt'  In  real  I. you 
don't  <vet  a  solution  to  your  programming  problems- 


WWW.headfirstlahs.com/hooks/hfcsharp  ttere’s  your  Chance  to  really  test  your  C#  knowledge 

^  and  see  just  how  much  you  ve  learned. 
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5  encapsulation 

*  m  ^ 

Keep  your  t'ivates...  + 

*  private 


Ever  wished  for  a  little  more  privacy? 

Sometimes  your  objects  feel  the  same  way.  Just  like  you  don’t  want  anybody  you 
don’t  trust  reading  your  journal  or  paging  through  your  bank  statements,  good  objects 
don’t  let  other  objects  go  poking  around  their  fields.  In  this  chapter,  you’re  going  to 
learn  about  the  power  of  encapsulation.  You’ll  make  your  object’s  data  private, 
and  add  methods  to  protect  how  that  data  is  accessed. 


this  is  a  new  chapter 
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kathleen  needs  your  help 


Kathleen  is  an  event  planner 


:Ueew  -would  ust>ieu  sve"d 
.  time  jlaww*  *''«**,  y'ot 


She’s  been  planning  dinner  parties  for 
her  clients  and  she’s  doing  really  well. 

But  lately  she’s  been  having  a  hard  time 
responding  to  clients  fast  enough  with  an 
estimate  for  her  services. 


When  a  new  client  calls  Kathleen  to  do  a  party,  she  needs  to  find 
out  the  number  of  guests,  what  kind  of  drinks  to  serve,  and  what 
decorations  she  should  buy.  Then  she  uses  a  pretty  complicated 
calculation  to  figure  out  the  total  cost,  based  on  a  flow  chart  she’s 
been  using  for  years.  The  bad  news  is  that  it  takes  her  a  long  time 
to  work  through  her  chart,  and  while  she’s  estimating,  her  potential 
clients  are  checking  out  other  event  planners. 

It’s  up  to  you  to  build  her  a  C#-driven  event  estimator  and  save 
her  business.  Imagine  the  party  she’ll  throw  you  when  you  succeed! 
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encapsulation 


What  does  the  estimator  do? 

Kathleen  runs  down  some  of  the  basics  of  her  system 
for  figuring  out  the  costs  of  an  event.  Here’s  part  of 
what  she  came  up  with: 


Kathleen’s  Parfq  Planning  Program-Cost  Estimate  for  a  Dinner  Party 

•  For  each  person  on  the  guest  list  there  s  a  $25  food  charge. 

•  Clients  have  a  choice  when  it  comes  to  drinks.  Most  parties  serve  alcohol,  which 
costs  $20  per  person.  But  they  can  also  choose  to  have  a  party  without  alcohol. 
Kathleen  calls  that  the  “Healthy  Option,”  and  it  only  costs  $5  per  person  to  have 
soda  and  juice  instead  of  alcohol.  Choosing  the  Healthy  Option  is  a  lot  easier  for 
her,  so  she  gives  the  client  a  57°  discount  on  the  entire  party,  too. 

.  There  are  two  options  for  the  cost  of  decorations.  If  a  client  goes  with  the 
normal  decorations,  it's  $1.50  per  person  with  a  $30  decorating  fee.  A  client  can 
also  upgrade  the  party  decorations  to  the  “Fancy  Option  -that  costs  $15  per 
person  with  a  $50  one-time  decorating  fee. 


Some  oP  -these  dhoides  involve 

Here’s  another  look  at  this  same  set  of  costs,  broken  a  dhange  to  the  -Pinal  pride  op 

down  into  a  little  flow  chart  to  help  you  see  how  it  works:  the  event,  as  well  as  individual 


per-person  dosts. 


you  are  here  ► 
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okay,  no  problem 


ExenciSe 


© 


© 


DinnerParty 

NumberOfPeople 

CostOfBeveragesPerPerson 

CostOfDecorations 


SetHealthyOption() 
CalculateCostOfDecorations() 
CalculateCost() 


need  ^  tveate' 


Build  a  program  to  solve  Kathleen’s  party  estimating  problem. 


Create  a  new  Windows  Application  project  and  add  a  class  file  to  it  called 
DinnerParty .  cs,  and  build  the  DinnerParty  class  using  the  class  diagram 
to  the  left.  It’s  got  three  methods:  CalculateCostOfDecorations  () , 
SetHealthyOption  ( ) ,  and  CalculateCost  ( )  .  For  the  fields,  use 
decimal  for  the  two  costs,  int  for  the  number  of  people,  and  bool  to 
keep  track  of  whether  or  not  the  healthy  option  was  selected.  Make  sure 
you  add  an  M  after  every  literal  you  assign  to  a  decimal  value  (10 . 0M). 


•Oh. 


CosiofB, 

o 


doht  heed  add  Vino 
System  WindowsForms;"  ^  y0IA. 
PinnerParty  dlass,  because  it 
does*  t  use  MessajeBox-ShowO, 

Poi^t,  or  anything  else  from  that 
Framework  namespade. 


Here’s  a  useful  C#  tool.  Since  the  cost  of  food  won’t  be  changed  by  the 
program,  you  can  declare  it  as  a  constant ,  which  is  like  a  variable  except 
that  its  value  can  never  be  changed.  Here’s  the  declaration  to  use: 

public  const  int  CostOf FoodPerPerson  =  25; 

Flip  back  to  the  previous  page  to  be  sure  you’ve  got  all  of  the  logic  right  for 
the  methods.  Only  one  of  them  returns  a  value  (a  decimal) — the  other 
two  are  void.  The  CalculateCostOfDecorations  ( )  method  figures 
out  the  cost  of  decorations  for  the  number  of  people  attending  the  party. 
Use  the  CalculateCost  ( )  method  to  figure  out  the  total  cost  by  adding 
up  the  cost  of  the  decorations  to  the  cost  of  drinks  and  food  per  person.  If 
the  client  wants  the  Healthy  Option,  you  can  apply  the  discount  inside  the 
CalculateCost  ( )  method  after  you’ve  figured  out  the  total  cost. 


Add  this  code  to  your  form: 


You'll  dedlare  ike  dinnerParty  -field  in 
ike  -form,  and  iken  add  these  four  lines 
below  IniiialiwComponeniO- 


DinnerParty  dinnerParty; 

public  Forml()  { 

InitializeComponent ( )  ; 

dinnerParty  =  new  DinnerParty ( )  {  NumberOfPeople  = 
— ^dinnerParty . SetHealthyOption (false) ; 

dinnerParty .CalculateCostOfDecorations (true) ; 
DisplayDinnerPartyCost ( ) ; 


5  }  ; 


} 


Sei  ike  de-fauli 
value  io  5.  Tke 
minimum  skould  be 
I  and  ike  maximum 
skould  be  2 -O 


Here’s  what  the  form 
should  look  like.  Use 
the  NumericUpDown 
control’s  properties  to  set 
the  maximum  number 
of  people  to  20,  the  Tke  Fandy 

minimum  to  1 ,  and  the  dedovaiions  box 
default  to  5.  Get  rid  of  the  should  kave  Ckedked 
maximize  and  minimize  sei  io  iv-ue 
buttons,  too. 

Tkis  is  just  a  label  witk  ike  Text  Property  set  io  ike  BorderStyle 

property  sei  io  Fixed^P,  and  ike  AutoSize  property  sei  to  false- 
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Q 

This  method  Will 
get  tailed  by  all  of 

the  other  methods 
Create  on  the 
:orm.  It's  how  you 
update  the  tost 
label  with  the  right 


l 


Instead  of  using  a  button  to  calculate  the  costs,  this  form  will  update  the  cost  label 
automatically  as  soon  as  you  use  a  checkbox  or  the  NumericUpDown  control.  The  first 
thing  you  need  to  do  is  create  a  method  in  the  form  that  displays  the  cost. 

Add  this  method  to  Forml  ( )  .  It’ll  get  called  when  the  NumericUpDown  control  is  clicked: 

Add  -this  method  to  the  form-it'll 
recalculate  the  Cost  of  the  party 


private 


void  DisplayDinnerPartyCost ( ) 

- "  a*d  p«t  it  in  the  Cost  label 

decimal  Cost  =  dinnerparty . CalculateCost (checkBox2 . Checked) 
value  whenever  - ^ costLabel . Text  =  Cost .  ToString  ("c")  ;  - - - — - J 

anything  changes.  }  T1  This  is  true  if  the 

Cka»5<  tke  m  of  te  ftui,,  y  b  TcQh>  „  t  „  ‘k“kb»*  **  tke  Htiltty 

aUfcJm  OfW  «  thated. 

Currency  value.  I-f  you're  in  a 
Country  that  uses  dollars,  it'll 
add  a  dollar  Sign. 


lablel  that  displays  the  Cost 
to  costLabel- 


When  you 
double-click 

on  a  button  in 

the  IDS  to  add 
Code  that  gets 
run  when  the 
button  is  clicked, 
that  s  an  event 
handler  too. 


Now  hook  up  the  NumericUpDown  field  to  the  NumberOfPeople  variable  you 
created  in  the  DinnerParty  class  and  display  the  cost  in  the  form.  Double-click  on  the 
NumericUpDown  control — the  IDE  will  add  an  event  handler  to  your  code.  That’s 
a  method  that  gets  run  every  time  the  control  is  changed.  It’ll  reset  the  number  of 
people  in  the  party.  Fill  it  in  like  this: 

private  void  numericUpDownl  ValueChanged ( 

object  sender,  EventArgs  e) 

{ 


dinnerParty . NumberOfPeople 
DisplayDinnerPartyCost  () ; 


=  (int)  numericUpDownl .Value ; 

{  You  need  -to  Cast  numericMpDowni/alue  to 
an  int  because  it's  a  Decimal  property- 


Uh-oh — there’s  a  problem  with  this  code.  Can  you  spot  it?  Don’t  worry  if  you 
don’t  see  it  just  yet.  We’ll  dig  into  it  in  just  a  couple  of  minutes! 


The  value  you  send  -from  the  form  to  the 
method  Will  be  fanCyBo*Checked-  That  will 
be  passed  as  a  boolean  parameter  to  the 
method  in  the  class. 


1 ^  -M 

-  ihe  y°v  created  in  the 


the 


°n  the  form. 


({Ttincy 


lS^L 


Decorations  checkbox  on  the  form  and  make 


Double-click  on  th 

sure  that  it  first  calls  CalculateCostOf Decorations  ( )  ,  and  then 
DisplayDinnerPartyCost  ( )  .  Next,  double-click  (hgjtjcahhy  Option? 
checkbox  and  make  sure  that  it  calls  the  SetHealthyOption  ( )  method  in  the 
DinnerParty  class  and  then  calls  the  DisplayDinnerPartyCost  ( )  method. 
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exercise  solution 


Here’s  the  code  that  goes  into  DinnerParty.es. 

Usmft  a  tonstant  (or  C°stOfP°odPerPerson 
ExGRC\S<i  ~  eKlSuV-es  -the  value  tan't  be  thanked  It  also 

§OLyt|OH  /  „akes  the  tode  easier  to  read— it's  tlear  that 

/  this  value  never  thanes. 

public  class  Dinnerparty  {  \|/  When  the  -form  -first  Creates 

const  int  CostOfFoodPerPerson  =  25;  )  the  object,  it  uses  the  initializer 

public  int  NumberOf People;  (  to  set  KumberOfPeople.  Then 

public  decimal  CostOfBeveragesPerPerson;  q  it  tails  SetttealthyOptionO  and 

public  decimal  CostOf Decorations  =  0;  \  CaltulateCostOfDetorationsO  to 

set  the  other  -fields. 

public  void  SetHealthyOption (bool  healthyOption)  { 
if  (healthyOption)  { 

CostOfBeveragesPerPerson  =  5.00M; 

}  else  {  (j 

CostOfBeveragesPerPerson  =  20.00M;  We  used  if  (Panty)  instead  ot 
}  typinOj  "if  (Panty  --  true)'  because 

}  the  it  statement  always  thetks  if  the 

tondition  is  true 

public  void  CalculateCostOfDecorations (bool  fancy)  { 
if  (fancy) 

{ 

CostOf Decorations  =  (NumberOf People  *  15.00M)  +  50M; 

}  else  { 

CostOf Decorations  =  (NumberOf People  *  7.50M)  +  30M; 

} 

} 

public  decimal  CalculateCost (bool  healthyOption)  { 
decimal  totalCost  =  CostOf Decorations  + 

( (CostOfBeveragesPerPerson  +  CostOfFoodPerPerson) 

*  NumberOf People) ; 


if  (healthyOption)  { 

return  totalCost  *  . 95M; 
}  else  { 

return  totalCost; 

} 


We  used  parentheses  to  make  sure  the 
math  works  out  properly. 


This  applies  the  5%  discount  to 
the  overall  event  tost  if  the 
non— altoholit  option  was  ehosen- 
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We  had  you  use  a  decimal  for  the  prices  because  it’s  designed  for  monetary  values.  Just  make 
sure  you  always  put  an  “M”  after  every  literal — so  if  you  want  to  store  $35.26,  make  sure  you 
write  35 . 2  6M. 


Form  { 


We  tail  DisplayDinnerPartyCost  ■to 
initialize  the  label  that  shows  the 
tost  as  soon  as  the  -form  s  loaded 


public  partial  class  Forml 
DinnerParty  dinnerParty; 
public  Forml ()  { 

InitializeComponent ( )  ; 
dinnerParty  =  new  DinnerParty ( )  {  NumberOf People  =  5  }; 

dinnerParty . CalculateCostOf Decorations ( fancyBox . Checked)  ; 
dinnerParty .  SetHealthyOption  (healthyBox .  Checked),; 
DisplayDinnerPartyCost ( ) ; 


} 


1  ^  Q  j  •  - 

Ganges  to  the  ehetkboy.es  on  the  -form  set 
.  the  healthyPftion  and  Fandy  booleans  to 

true  or  talse  in  the  SetHealthyOptionO  and 
CaltulateCostO-fPetorationsO  methods. 


We  named  our  dhedkboxes  "healthyBox" 
and  tandyBox  so  you  tould  see  what’s 


private  void  fancyBox_CheckedChanged (object  sender,  EventArgs  e)  { 
dinnerParty . CalculateCostOf Decorations ( fancyBox . Checked) ; 
DisplayDinnerPartyCost ( )  ; 

}  ana  randyDox  so  you 

going  on  in  their  event  handler  methods. 

private  void  healthyBox  CheckedChanged (object  sender,  EventArgs  e)  { 
dinnerParty . SetHealthyOption (healthyBox . Checked) ; 
DisplayDinnerPartyCost ( )  ; 

} 

private  void  numericUpDownl  ValueChanged (object  sender,  EventArgs  e)  { 
dinnerParty .NumberOf People  =  (int) numericUpDownl .Value; 

DisplayDinnerPartyCost  ( )  ;  — - The  new  dinner  party  dost  needs  to  be 

}  - -  .  vedaldulated  and  displayed  any  time  the  number 


dhanges  or  the  dhedkboxes  are  dhedked 

private  void  DisplayDinnerPartyCost ( )  { 

decimal  Cost  =  dinnerParty . CalculateCost (healthyBox . Checked) ; 
costLabel . Text  =  Cost . ToString ("c" ) ; 


} 


S'brmj  -fovnna'ttmj 


/ou  ve  already  seen  how  you  dan  donvert  any  variable  to  a  string  using  its  ToString 0  method- 
1+  you  pass  Y  to  ToStringO,  it  donverts  it  to  the  lodal  durrendy.  You  dan  also  pass  it  "ft"  to 
■format  it  With  as  a^dedimal  number  with  three  dedimal  plades,  "O"  (that's  a  zero)  to  donvert  to 
a  whole  number,  “0%"  tor  a  whole  number  perdentage,  and  "n"  to  display  it  as  a  number  with  a 
domma  separator  tor  thousands.  Take  a  minute  and  see  how  eadh  ot  these  looks  in  your  program/ 
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something’s  gone  terribly  wrong 


Kathleen's  Test  Prive 


This  rocks! 
Estimating  is  about  to 
get  a  whole  lot  easier. 


Rob’s  one  of  Kathleen  s 

w«te  sv,e  d;d 

wedding  last  "/ear,  and  now 
/  she’s  planning  an  .mutant 

/  /Wr  vartv  ton  him- 


Rob  (on  phone):  Hi  Kathleen.  How  are  the  arrangements 
for  my  dinner  party  going? 


Kathleen:  Just  great.  We  were  out  looking  at  decorations  this 
morning  and  I  think  you’ll  love  the  way  the  party’s  going  to 
look. 


Rob:  That’s  awesome.  Listen,  we  just  got  a  call  from  my  wife’s 
aunt.  She  and  her  husband  are  going  to  be  visiting  for  the  next 
couple  of  weeks.  Can  you  tell  me  what  it  does  to  the  estimate 
to  move  from  1 0  to  12  people  on  the  guest  list? 

Kathleen:  Sure!  I’ll  have  that  for  you  in  just  one  minute. 


Number  of  People 

It  2 


@  Fancy  decorations 
I  I  Healthy  Option 

Cost  $665 


Changing  -the  H 
People  value  -Pv-c 
and  hitting  ent 
as  -the  total  do: 
seems  a  little  lc 


Kathleen:  OK.  It  looks  like  the  total  cost  for  the  dinner  will 
go  from  $575  to  $665. 

Rob:  Only  $90  difference?  That  sounds  like  a  great  deal!  What 
if  we  decide  to  cut  the  fancy  decorations?  What’s  the  cost  then? 


bev  o-P 

10  to  1 2 
shows  ftb’y 

Hmm,  that 
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Kathleen:  Um,  it  looks  like...  um,  $660. 

Rob:  $660?  I  thought  the  decorations  were  $15  per  person.  Did  you  change  your 
pricing  or  something?  If  it’s  only  $5  difference,  we  might  as  well  go  with  the  Fancy 
Decorations.  I’ve  gotta  tell  you  though,  this  pricing  is  confusing. 

Kathleen:  We  just  had  this  new  program  written  to  do  the  estimation  for  us. 

But  it  looks  like  there  might  be  a  problem.  Just  one  second  while  I  add  the  fancy 
decorations  back  to  the  bill. 


Men  701*  k"  the  fan 

petov-ations  batk  on,  e 
wmber  shoots  u?  to  iVO. 

These  niA">bets  a«  *£3* 


Kathleen:  Rob,  I  think  there’s  been  a  mistake.  It  looks  like  the  cost  with  the  fancy 
decorations  just  shot  up  to  $770.  That  does  seem  to  make  more  sense.  But  I  am 
beginning  not  to  trust  this  application.  I’m  going  to  send  it  back  for  some  bug  fixes 
and  work  up  your  estimate  by  hand.  Can  I  get  back  to  you  tomorrow? 

Rob:  I  am  not  paying  $770  just  to  add  two  people  to  the  party.  The  price  you 
quoted  me  before  was  a  lot  more  reasonable.  I’ll  pay  you  the  $665  you  quoted  me  in 
the  first  place,  but  I  just  can’t  go  higher  than  that! 


Why  do  you  think  the  numbers  are  coming  out  wrong  every  time  Kathleen  makes  a  change? 
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wasn’t  expecting  that 

Each  option  should  be  calculated  individually 

Even  though  we  made  sure  to  calculate  all  of  the  amounts  according 
to  what  Kathleen  said,  we  didn’t  think  about  what  would  happen  when 
people  made  changes  to  just  one  of  the  options  on  the  form. 

When  you  launch  the  program,  the  form  sets  the  number  of  people  to  5 
and  Fancy  Decorations  to  true.  It  leaves  Healthy  Option  unchecked  and 
it  calculates  the  cost  of  the  dinner  party  as  1350.  Here’s  how  it  comes  up 
with  the  initial  total  cost: 


o 


Don’t  worry! 
This  one 
wasn’t  your 
fault. 

We  built  a  nasty  little  bug  into 
the  code  we  gave  you  to  show 
you  just  how  easy  it  is  to  have 
problems  with  how  objects  use 
each  others’  fields...  and  just  how 
hard  those  problems  are  to  spot. 


5  people. 

*20  per  person  for  drinks  — - 

*25  per  person  for  food  - - 

*15  per  person  for  decorations 
plus  *50  fee. 


Total  cost  of  drinks  *  *100 
Total  cost  of  food  =  *125 
Total  cost  of  decorations  =  *125 


Number  of  People 

n 

0  Fancy  decorations 
I  I  Healthy  Option 

Cost  $350 


far, 


)  So 


*100*  *125*125  =  *550 


3°od. 


When  you  change  the  number  of  guests,  the  application  should 
recalculate  the  total  estimate  the  same  way.  But  it  doesn’t: 


1 0  people. 


*20  per  person  for  drinks - >  Total  cost  of  drinks  =  *200 

*25  per  person  for  food - s-  Total  cost  of  food  =  *250 


Number  of  People 

ITo  : 


*15  per  person  for  decorations 
plus  *50  fee. 


Total  cost  of  decorations  =  *200 


1 


*200  **250*  200  =*650 

/ 

U,s  h  the  total 
^t  're  not... 


0  Fancy  decorations 
I  I  Healthy  Option 


The  program  is  adding  the  ojd  Cost  of 
decorations  up  with  the  new  Cost  of 
•food  and  drink- 

It's  doing  jlOO  +  /2JSO  +  /12.5s.  fT/S 
and  drink  tlt^  °]A 
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Take  a  look  at  the  method  that  handles  changes  to  the  value  in  the  numericUpDown 
control.  It  sets  the  value  from  the  field  to  the  Numberof  People  variable  and  then 
calls  the  DisplayDinnerPartyCost  ( )  method.  Then  it  counts  on  that  method 
to  handle  recalculating  all  the  individual  new  costs. 


encapsulation 


private  void  numericUpDownl  ValueChanged ( 

object  sender,  EventArgs 

dinnerParty .NumberOf People  =  (int) numericUpDownl .Val 


This  line  sets  the  value 
of  Nu"tev-o{Pe°?'e 

in  this  instate  ok 

rpiwevPa'rtv  to  the 
value  in  the  for*- 


DisplayDinnerPartyCost ( ) ; 


This  method  tails  the  CaltulateCostO  method,  but  n°t 

the  CaltulateCostofDetovationsO  method- 


So,  when  you  make  a  change  to  the  value  in  the  NumberofPeople  field, 
this  method  never  gets  called: 


public  void  CalculateCostOf Decorations (bool  Fancy)  {  ( 

This  variable  is  set  to  ?l2-5  from  when  the 

if  (Fancy)  {  ^ - form  first  tailed  it  and,  sinte  this  method 

doesn't  get  tailed  again,  it  doesn't  thange- 

CostOf Decorations  =  (NumberOf People  *  15.00M)  +  50M; 

}  else  { 


} 


CostOf Decorations 


(NumberOf People  *  7.50M)  +  30M; 


That's  why  the  number  torretts  itself  when  you  turn 
fanty  detonations  batk  on-  Clitking  the  thetkbo*  makes 
the  program  run  CaltulateCostOf  PetorationsO  again. 


Hold  on!  I  assumed  Kathleen  would 
always  set  all  three  options  at  once! 


People  won’t  always  use  your  programs  in 
exactly  the  way  you  expect. 

Luckily,  C#  gives  you  a  powerful  tool  to  make  sure  your 
program  always  works  correctly — even  when  people  do 
things  you  never  thought  of.  It’s  called  encapsulation 
and  it’s  a  really  helpful  technique  for  working  with  objects. 
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protect  your  objects 


It's  easy  to  accidentally  misuse  your  objects 

Kathleen  ran  into  problems  because  her  form  ignored  the 
convenient  CalculateCostOf  Decorations  ( )  method  that 
you  set  up  and  instead  went  directly  to  the  fields  in  the  DinnerParty 
class.  So  even  though  your  DinnerParty  class  worked  just  fine,  the 
form  called  it  in  an  unexpected  way...  and  that  caused  problems. 


o 


How  the  DinnerParty  class  expected  to  be  called 

The  DinnerParty  class  gave  the  form  a  perfectly  good  method  to  calculate  the 
total  cost  of  decorations.  All  it  had  to  do  was  set  the  number  of  people  and  then 
call  CalculateCostOf  Decorations  ( ) ,  and  then  CalculateCost  ( ) 
will  return  the  correct  cost. 


NumberOf People  -  10; 

CalculateCostOf Decorations (false) ; 


A>- 


CalculateCost  ()  returns  $650 


\erPcf* 


o 

<y 


<r 


O/-,, 


’m 


© 


How  the  DinnerParty  class  was  actually  called 

The  form  set  the  number  of  people,  but  just  called  the  CalculateCost  ( ) 
method  without  first  recalculating  the  cost  of  the  decorations.  That  threw  off 
the  whole  calculation,  and  Kathleen  ended  up  giving  Rob  the  wrong  price. 


CalculateCost  ( )  returns  $350 


Even  -though  the  -form  didn't  set  up  the 
party  properly,  CalculateCost  () 
still  returned  a  number...  and  there  was 
no  way  -for  Kathleen  -to  know  that  the 
number  was  wrong. 
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Encapsulation  means  keeping  some  of 
the  data  in  a  class  private 

There’s  an  easy  way  to  avoid  this  kind  of  problem:  make  sure  that  there’s  only  one 
way  to  use  your  class.  Luckily,  C#  makes  it  easy  to  do  that  by  letting  you  declare 
some  of  your  fields  as  private.  So  far,  you’ve  only  seen  public  fields.  If  you’ve 
got  an  object  with  a  public  field,  any  other  object  can  read  or  change  that  field. 
But  if  you  make  it  a  private  field,  then  that  field  can  only  be  accessed  from 
inside  that  object  (or  by  another  object  of  the  same  class). 


Use  your  laziness  youv. 

7*  you  leave 

u°ff  the  "private"  or 
VW'fi",  then  C#  will  just 
assume  that  your  -field  is 
pvivate. 


public  class  DinnerParty  { 

private  int  numberOf People ; 


.  *.  , ,  - -  rriv«e<  ail  you  need  to 

l  n7  tii  Sit?  ckeyTd  whe»  y  dalare 

t-  That  tells  C#  that  ,f  you  ve  got  a,  instance  of 
P  erjarty,  .ts .numberOf People  -field  ear  only 
be  read  and  written  by  that  instance.  Other  objec-b 
won  t  even  know  it  s  there.  ^ 


public  void  SetPartyOptions ( int  people,  bool  fancy)  { 


numberOf People  =  people; 
Cal cu la t eCostOf Decora t 


public  void  GetNumberOf Peopl 
return 


ions ( fancy) ; 

v 

ur' 


e  ( )  { 


numberOf People ; 


good  way  to  give  them  access -b>  t  to 
add  methods  to  set  or  get  the  -mberol^ 
people-  That  way  you  tan  make  su 

CalculateCostOf Decorations 0 

method  gets  run  every  time  the  ^mber  of 
people  is  Changed-  That’ll  take  care  of  that 


By  making  the  field  that  holds  the  number 
of  party  guests  private,  we  only  give  the 
form  one  way  to  tell  the  DinnerParty  class 
how  many  people  are  at  the  party — and 
we  can  make  sure  the  cost  of  decorations 
is  recalculated  properly.  When  you  make 
some  data  private  and  then  write  code  to 
use  that  data,  it’s  called  encapsulation. 


en-cap-su-la-ted,  adj. 

enclosed  by  a  protective  coating 
or  membrane.  The  divers  were  fully 
encapsulated  by  their  submersible, 
and  could  only  enter  and  exit  through 
the  airlock. 
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spy  spy 


Use  encapsulation  to  control  access  to  your 
class's  methods  and  fields 

When  you  make  all  of  your  fields  and  methods  public,  any  other  class 
can  access  them.  Everything  your  class  does  and  knows  about  becomes 
an  open  book  for  every  other  class  in  your  program...  and  you  just  saw 
how  that  can  cause  your  program  to  behave  in  ways  you  never  expected. 
Encapsulation  lets  you  control  what  you  share  and  what  you  keep  private 
inside  your  class.  Let’s  see  how  this  works: 


O 


Super-spy  Herb  Jones  is  defending  life,  liberty,  and  the  pursuit  of 
happiness  as  an  undercover  agent  in  the  USSR.  His  ciaAgent  object  is  an 
instance  of  the  SecretAgent  class. 


RealName:  "Herb  Jones" 

Alias:  "Dash  Martin" 

Password:  "the  crow  flies  at  midnight" 


SecretAgent 

Alias 

RealName 

Password 


AgentGreetingQ 


0 


Agent  Jones  has  a  plan  to  help  him  evade  the  enemy  KGB  agents.  He 
added  an  AgentGreeting  ( )  method  that  takes  a  password  as  its 
parameter.  If  he  doesn’t  get  the  right  password,  he’ll  only  reveal  his 
alias,  Dash  Martin. 


e 


Seems  like  a  foolproof  way  to  protect  the  agent’s  identity,  right?  As 
long  as  the  agent  object  that  calls  it  doesn’t  have  a  the  right  password, 
the  agent’s  name  is  safe. 


EnemyAgent 

Borscht 

Vodka 


ContactComarades() 

OverthrowCapitalistsQ 
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Put  is  the  realName  field  REALLY  protected? 

So  as  long  as  the  KGB  doesn’t  know  any  CIA  agent  passwords,  the 
CIA’s  real  names  are  safe.  Right?  But  what  about  the  field  declaration 
for  the  realName  field: 


Setting  your  variables 
publit  means  -they  tan  be  - 
attessed,  and  even  thanked, 
•from  outside  the  tlass. 


public  string  RealName; 


from  outside  the  tlai^  ^  6ha^ed‘ 


ciaAgent . RealName; 


:'s  no  need  to  tall  any 
.a  The  realName  tield 


The  kgbAgent  object  tan't 


enemy  spy  objects.  Once  he  declares  the  realName  field  as  private,  the 

only  way  to  get  to  it  is  by  calling  methods  that  have  access  to  the 
private  parts  of  the  class.  So  the  KGB  agent  is  foiled! 


Agent  Jones  can  use  private  fields  to  keep  the  his  identity  secret  from 


Just  ^Pkte  public  with 
£7?^  boom,  your 
p'lds  are  „ow  hidden 
+’rom  the  world. 


^ N  yvur  TieiOS  d hO  rwCthOwi 

private  makes  sure  no  outside 

private  string  realName; 

yl  don't  expect  it- 


Y»'d  *.  «9»t  t» 

the  enemy  agent  tan  get  to  « 
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keeping  secrets 


Private  fields  and  methods  caw  owly  be 
accessed  from  iwside  the  class 


There’s  only  one  way  that  an  object  can  get  at  the  data  stored  inside  another 
object’s  private  fields:  by  using  the  public  fields  and  methods  that  return  the  data. 
But  while  KGB  and  MI5  agents  need  to  use  the  AgentGreetingO  method,  friendly 
spies  can  see  everything — any  class  can  see  private  fields  in  other  instances 
of  the  same  class. 


""fyeni  is 

instate  o-P 

BtrrtishAgeivt  class,  ^\v 

so 't  doesn't  lijVe  ^ 
access  {o  ciaAgehi's 
-fields  either. 

f 

Only  Jhother 
C'^Agent  object 
can  see  them. 


Now  that  the  -fields  are  private, 
this  is  prett/  much  the  onljf 
■way  the  mi^Agent  can  get  the 


ciaAgent’s  real  name- 


AgentGreeting ("the  crow  flies 


at  midnight") 


"Herb  Jones 


tlierciarc  no 

Dumb  Questions 


Tke  only 


Okay,  so  I  need  to  access  private  data 
through  public  methods.  But  what  happens  if  the 
class  with  the  private  field  doesn’t  give  me  a  way 
to  get  at  that  data,  but  my  object  needs  to  use  It? 

Then  you  can’t  access  the  data  from  outside  the 
object.  When  you're  writing  a  class,  you  should  always 
make  sure  that  you  give  other  objects  some  way  to 
get  at  the  data  they  need.  Private  fields  are  a  very 
important  part  of  encapsulation,  but  they're  only  part 
of  the  story.  Writing  a  class  with  good  encapsulation 
means  giving  a  sensible,  easy-to-use  way  for  other 
objects  to  get  the  data  they  need,  without  giving  them 
access  to  hijack  data  your  class  needs. 


0:  Why  would  I  ever  want  to  keep  a  field  with  no 
way  for  another  class  to  access? 


Sometimes  a  class  needs  to  keep  track  of 
information  that  is  necessary  for  it  to  operate,  but 
which  no  other  object  really  needs  to  see.  Here's  an 
example.  When  computers  generate  random  numbers, 
they  use  special  values  called  seeds.  You  don't  need 
to  know  how  they  work,  but  every  instance  of 


Random  actually  contains  an  array  of  several  dozen 
numbers  that  it  uses  to  make  sure  that  Next  ( ) 
always  gives  you  a  random  number.  If  you  create  an 
instance  of  Random,  you  won't  be  able  to  see  that 
array.  That's  because  you  don't  need  it— but  if  you 
had  access  to  it,  you  might  be  able  to  put  values  in  it 
that  would  cause  it  to  give  non-random  values.  So  the 
seeds  have  been  completely  encapsulated  from  you. 

0:  Hey,  I  just  noticed  that  all  of  the  event 
handlers  I’ve  been  using  have  the  private 
keyword.  Why  are  they  private? 

Because  C#  forms  are  set  up  so  that  only  the 
controls  on  the  forms  can  trigger  event  handlers. 

When  you  put  the  private  keyword  in  front  of 
any  method,  then  that  method  can  only  be  used  from 
inside  your  class.  When  the  IDE  adds  an  event  handler 
method  to  your  program,  it  declares  it  as  private  so 
other  forms  or  objects  can't  get  to  it.  But  there's  no  rule 
that  says  that  an  event  handler  must  be  private.  In  fact, 
you  can  check  this  out  for  yourself— double-click  on  a 
button,  then  change  its  event  handler  declaration  to 
public.  The  code  will  still  compile  and  run. 


way  that 
one  object 
can  get  to 
data  stored 
in  a  private 
field  inside 
another 
object  is  by 
using  public 
methods 
that  return 
tke  data. 
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Here's  a  class  with  some  private  fields.  Circle  the  statements 
below  that  won't  compile  if  they're  run  from  outside  the 
class  using  an  instance  of  the  object  called  mySuperChef. 


public  class  SuperChef 

{ 

public  string  cookieRecipe; 
private  string  secretlngredient; 

private  const  int  loyalCustomerOrderAmount  =  60; 

public  int  Temperature; 

private  string  ingredientSupplier; 


public  string  GetRecipe  (int  orderAmount) 

{ 

if  (orderAmount  >=  loyalCustomerOrderAmount) 

{ 

return  cookieRecipe  +  "  "  +  secretlngredient; 

} 

else 

{ 

return  cookieRecipe; 

} 


} 


1.  string  ovenTemp  =  mySuperChef . Temperature; 

2.  string  supplier  =  mySuperChef . ingredientSupplier ; 

3.  int  loyalCustomerOrderAmount  =  94; 

4.  mySuperChef . secretlngredient  =  "cardamom"; 

5.  mySuperChef . cookieRecipe  =  "get  3  eggs,  2  1/2  cup  flour,  1  tsp  salt, 
1  tsp  vanilla  and  1.5  cups  sugar  and  mix  them  together.  Bake  for  10 
minutes  at  375.  Yum!"; 

6.  string  recipe  =  mySuperChef . GetRecipe ( 56 ) ; 

7.  After  running  all  of  the  lines  that  will  compile  above,  what's  the  value  of  recipe? 
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good  ideas  for  easy  encapsulation 

^Jharpen  your  pencil . 
Solution 


public  class  SuperChef 


Here's  a  class  with  some  private  fields.  Circle  the  statements 
below  that  won't  compile  if  they're  run  from  outside  the 
class  using  an  instance  of  the  object  called  mySuperChef. 


{ 


public  string  cookieRecipe; 


private  string  ..secretlngredient; 
-  >  ^ 


This  is  a  private  constant- 

_ _ |-ts  value  can't  be  thawed, 

__ _  j  a  ta„’t  be  accessed 

private  <consJ^  mt  loyalCustomerOrderAmount  =  60;  of  this  class 

public  int  Temperature; 

private  string  ingredientSupplier; 

public  string  GetRecipe  (int  orderAmount) 

{ 

if  (orderAmount  >=  loyalCustomerOrderAmount) 


{ 


} 

else 

{ 

} 


return  cookieRecipe  + 
+  secretlngredient; 


return  cookieRecipe; 


and  the  secret  ingredient  is 


The  only  way  to  get  the  secret 
ingredient  is  to  order  a  whole 
lot  of  Cookies.  Outside  Code 
can't  access  this  -f  ield  directly- 


#1  doesn  t  Compile  because  you 


tjustring  ovenTemp  =  mySuperChef  .  Temperature ^ 

- - - - ^  Assign  an  int  to  a 

(^Tstring  supplier  =  mySuperChef .  ingredientSupplier^^  string. 

3.  int  loyalCustomerOrderAmount  =  54;  and  don't  Compile 

_ _ _ _ because  ingredientSupplier  and 

(4~.  mySuperChef .  secretlngredient  =  "cardamom^j^  secretlngredient  are  private- 


5.  mySuperChef . cookieRecipe  =  "Get  3  eggs,  2  1/2  cup  flour,  1  tsp  salt, 

1  tsp  vanilla  and  1.5  cups  sugar  and  mix  them  together.  Bake  for  10 
minutes  at  375  .  Yum!";  Even  though  you  Created  a  local  variable  Called 

loyalCustomerAmount  and  set  it  to  that 

6.  string  recipe  =  mySuperChef  .GetRecipe  (56)  ;  didn  t  Change  the  object's  loyalCustomerA  •/- 

value,  which  is  still  i>0-so  it  won't  print  thl 
secret  ingredient-  / 

7.  After  running  all  of  the  lines  that  will  compile  above,  what's  the  value  of  recipe?  \Z 

"£jet  3  eggs,  Z  I  /Z  Cup  flour,  I  tsp  salt,  I  tsp  vanilla  and  I  “5  cups  sugar  and  mi*  them  together. 

Bake  for  1 0  minutes  at  T71?-  Vum|" 
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A  few  ideas  for  encapsulating'  classes 


*  Think  about  ways  the  fields  can  be  misused. 

What  can  go  wrong  if  they're  not  set  properly? 

*  Is  everything  in  your  class  public? 

If  your  class  has  nothing  but  public  fields  and  methods,  you  probably 
need  to  spend  a  little  more  time  thinking  about  encapsulation. 

4  What  fields  require  some  processing  or  calculation  to 
happen  when  they're  set? 

Those  are  prime  candidates  for  encapsulation.  If  someone  writes 
a  method  later  that  changes  the  value  in  any  one  of  them,  it  could 
cause  problems  for  the  work  your  program  is  trying  to  do. 


4  Only  make  fields  and  methods  public  if  you  need  to. 

If  you  don't  have  a  reason  to  declare  something  public,  don't.  You  could 
make  things  really  messy  for  yourself  by  making  all  of  the  fields  in  your 
program  public — but  don't  just  go  making  everything  private,  either. 
Spending  a  little  time  up  front  thinking  about  which  fields  really  need  to 
be  public  and  which  don't  can  save  you  a  lot  of  time  later. 


you  are  here  ► 


191 


get  it,  set  it,  got  it,  good 


Encapsulation  keeps  your  data  pristine 

Sometimes  the  value  in  a  field  changes  as  your  program  does 
what  it’s  supposed  to  do.  If  you  don’t  explicitly  tell  your  program 
to  reset  the  value,  you  can  do  your  calculations  using  the  old 
one.  When  this  is  the  case,  you  want  to  have  your  program 
execute  some  statements  any  time  a  field  is  changed — like 
having  Kathleen’s  program  recalculate  the  cost  every  time 
you  change  the  number  of  people.  We  can  avoid  the  problem 
by  encapsulating  the  data  using  private  fields.  We’ll  provide  a 
method  to  get  the  value  of  the  field,  and  another  method  to  set 
the  field  and  do  all  the  necessary  calculations. 

A  quick  example  of  encapsulation 

A  Farmer  class  uses  a  field  to  store  the  number  of  cows,  and 
multiplies  it  by  a  number  to  figure  out  how  many  bags  of  cattle 
feed  are  needed  to  feed  the  cows: 

We'd  better  make  this  -f  ield 
so  nobody  car  Charge  it  Without  also 
changing  bagsO-f  Feed— if  they  get 
out  of  syrC,  that'll  Create  bugs' 


class  Farmer 
{ 

private  int  numberOfCows; 

} 


When  you  create  a  form  to  let  a  user  enter  the  number  of  cows  into  a  numeric  field, 
you  need  to  be  able  to  change  the  value  in  the  numberOfCows  field.  To  do  that,  you 
can  create  a  method  that  returns  the  value  of  the  field  to  the  form  object. 

public  const  int  FeedMultiplier 
public  int  GetNumberOfCows ( ) 


The  farmer 

needs  SO  bag: 

of  feed  f  <*■ 
each  cow- 


{ 


return  numberOfCows; 


add  a  method  -to  give 
other  classes  a  way  to  get 
the  rumber  of  Cows. 


public  void  SetNumberOf Cows ( int  newNumberOfCows / 

{ 


numberOfCows  =  newNumberOfCows ; 

BagsOfFeed  =  numberOfCows  *  FeedMultiplier; 


We 


used  camelCase  for  the  private  f  ields^ 


a«d  PascalCase  for  the  public  ones. 


And  here’s  a  method  to  set  the 
number  of  Cows  that  makes  sure 
the  BagsOfFeed  field  is  changed 

\ - too.  Now  there’s  no  way  tor  the 

two  to  get  out  of  sync. 
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Properties  make  encapsulation  easier 


C#  has  special  kinds  of  methods  that  make  it  easy  to  encapsulate  your  data.  You 
can  use  properties,  methods  that  are  executed  every  time  a  field  is  called  to  set 

-ve  „  -the  private  field  to  w*«b, evOfCows 

(notide  the  lowerdase  V')-  Tbiswill  bedome  tbe 

private  int  numberOf Cows ; 


or  return  the  value  of  the  field,  which  is  called  a  backing  field. 

We’ll  rename 


C-dSC  n  * . . 

the  NumberOf  Cows  property. 


public  int  NumberOf Cows 


{ 


badking  -field 

USe  by  dombining  them  with 

^ormaltield  dedlaraW  Here's  the 

dedlaration  tor  WUmb 


ows. 


get 

{ 

} 


This  is  a  get  addessor  It's  a  method  that*  run  any  time 
the  NumberOf  Cows  -f  ield  is  read-  It  has  a  return  value 

_ that  matdhes  the  type  of  the  variable-in  this  ease  .t 

'  ^  returns  the  value  ot  the  private  numberOf  Cows  Held- 

return  numberOf Cows ; 

_ _ -  F  j ‘  ; ’  tws  called  every  W  -tke 

Uk  fc + 1?  t,M  -rfW  ,Wt 

.  ;t  has  fy  f-M-eters,  It  actually  kai  called  ,al,e 
that  dontams  whatever  value  the  field  was  set  to. 

numberOf Cows  =  value; 

BagsOfFeed  =  numberOf Cows  *  FeedMultiplier ; 


} 


You  use  get  and  set  accessors  exactly  like  fields.  Here’s  code  for  a  button  that  sets  the 
numbers  of  cows  and  then  gets  the  bags  of  feed: 

private  void  buttonl^Click (object  sender,  EventArgs  e)  { 

Farmer  myFarmer  =  new  Farmer  ( )  ;  _ 

myFarmer .NumberOf Cows  =  10;  — 


When  this  line  sets 
NumberOfCows  to  10,  the 
set  addessor  sets  the 
private  numberOfCows  field 
and  then  updates  the  publid 
BagsOf  Feed  -field 


int  howManyBags  =  myFarmer . BagsOfFeed;  ,/ 


myFarmer .NumberOf Cows  =  20; 
howManyBags  =  myFarmer .BagsOfFeed; 


Fven  tbougb  tbe  dode  treats  NumberOf  Cows  like 
a  field,  it  runs  tbe  set  addessor,  passing  «t  W 
And  when  it  queries  the  BagsOfFeed  f  .eld  it  runs 
the  get  addessor,  whidh  returns  100- 


Cinde  the  (lumber  Of  Cows  set 
addessor  updated  BagsOfFeed, 
now  you  dan  get  its  value- 
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private  property  (no  tresspassing) 


Build  an  application  to  test  the  Farmer  class 

Create  a  new  Windows  Forms  application  that  we  can  use  to  test  the  Farmer 
class  and  see  properties  in  action.  We’ll  use  the  Console  .  WriteLine  ( ) 
method  to  write  the  results  to  the  output  window  in  the  IDE. 

Add  the  Farmer  class  to  your  project: 

public  class  Farmer  { 

public  int  BagsOfFeed; 
public  const  int  FeedMultiplier  =  30; 


Do  f  ills  + 


private  int  numberOfCows; 
public  int  NumberOfCows  { 

(add  the  get  and  set  accessors  from  the  previous  page) 

} 


© 


Build  this  form: 


Cow  Calculator 


|\lame  "this  button  Calculate— it 
uses  the  public  Farmer  data  to 
write  a  line  to  the  output- 


Set  the  M*meridMpDown 
Control's  i/alue  to  IS,  its 
/Minimum  to  5,  and  its 
/Maximum  to  iOO. 


© 


Here’s  the  form  for  the  code.  It  uses  Console  .  WriteLine  ( )  to  send  its  output  to  the  Output 
window  (which  you  can  bring  up  by  selecting  “Output”  from  the  View  menu).  You  can  pass  several 
parameters  to  WriteLine  ()  — the  first  one  is  the  string  to  write.  If  you  include  “  {  0  }  ”  inside  the 
string,  then  WriteLine  ( )  replaces  it  with  the  first  parameter.  It  replaces  “  { 1 }  ”  with  the  second 
parameter,  “  { 2  }  ”  with  the  third,  etc. 


public  partial  class  Forml  :  Form  { 

Farmer  farmer; 
public  Forml ( )  { 

InitializeComponent ( ) ; 

farmer  =  new  Farmer))  {  NumberOfCows  =15  }; 


} 


} 

private  void  numericUpDownl_ValueChanged (obj ect  sender,  EventArgs  e)  { 
farmer . NumberOfCows  =  (int) numericUpDownl .Value; 


} 


private  void  calculate_Click (object  sender,  EventArgs  e)  { 
Console . WriteLine  ("I  need  {0}  bags  of  feed  for  {1}  cows'1 
farmer . BagsOfFeed,  farmer . NumberOfCows) ; 


Mse  tbe  Console-MriteLineO 
etbod  to  send  a  line  of  -text 
to  tbe  IDE's  Output  window. 


iVv-iteUneO  replaces  "{o}''  with  value  m 
tbe  -first  parameter,  and  "{l}  with  tbe 
second  parameter. 
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Use  automatic  properties  to  finish  the  class 

It  looks  like  the  Cow  Calculator  works  really  well.  Give  it  a  shot — run  it  and  click 
the  button.  Then  change  the  number  of  cows  to  30  and  click  it  again.  Do  the  same 
for  5  cows  and  then  20  cows.  Here’s  what  your  Output  window  should  look  like: 


But  there’s  a  problem  with  the  class.  Add  a  button  to  the  form  that  executes  this  statement: 

farmer . BagsOf Feed  =  5; 

Now  run  your  program  again.  It  works  fine  until  you  press  the  new  button.  But  press 
that  button  and  then  press  the  Calculate  button  again.  Now  your  ouput  tells  you  that 
you  need  5  bags  of  feed — no  matter  how  many  cows  you  have! 

Fully  encapsulate  the  Farmer  class 


Automatic 
properties 
are  a  C#  3.0 
feature. 

If  you’re  still 
using  Visual 
Studio  2005 
and  C#  2.0, 
this  code  won’t 
work.  We  highly 
recommend  that 
you  use  Visual 
Studio  2008 
Express.  You 
can  download  it 
for  free! 


The  problem  is  that  your  class  isn’t  fully  encapsulated.  You  used  properties  to 
encapsulate  NumberOfCows,  but  BagsOfFeed  is  still  public.  This  is  a  common  problem. 

In  fact,  it’s  so  common  that  C#  has  a  way  of  automatically  fixing  it.  Just  change  the  snippet 

public  BagsOfFeed  field  to  an  automatic  property.  And  the  IDE  makes  it  really  easy  "to  sbt  v-oPevty  io 

for  you  to  add  automatic  properties.  Here’s  how: 

LS  your  Code. 

Q  Remove  the  BagsOfFeed  field  from  the  Farmer  class.  Put  your  cursor  where  the  field  used  to  be, 
and  then  type  prop  and  press  the  tab  key  twice.  The  IDE  will  add  this  line  to  your  code: 


public  |int|  MyProperty  {  get;  set;  } 


© 

© 


Press  the  tab  key — the  cursor  jumps  to  MyProperty.  Change  its  name  to  BagsOfFeed: 

public  int  BagsOfFeed  {  get;  set;  } 

Now  you’ve  got  a  property  instead  of  a  field.  When  C#  sees  this,  it  works  exactly  the  same  as  if  you 
used  a  backing  field  (like  the  private  numberOf Cows  behind  the  public  NumberOfCows  property). 

That  hasn’t  fixed  our  problem  yet.  But  there’s  an  easy  fix — just  make  it  a  read-only  property: 

public  int  BagsOfFeed  {  get;  private  set;  } 

Try  to  rebuild  your  code — you’ll  get  an  error  on  the  line  in  the  button  that  sets  BagsOfFeed  telling 
you  that  the  set  accessor  is  private.  Now  your  Farmer  class  is  better  encapsulated! 


you  are  here  ► 
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set  it  up 


What  if  we  want  to  change  the  feed  multiplier? 

We  built  the  Cow  Calculator  to  use  a  const  for  the  feed  multiplier.  But  what  if  we  want 
to  use  the  same  Farmer  class  in  different  programs  that  need  different  feed  multipliers? 
You’ve  seen  how  you  poor  encapsulation  can  cause  problems  when  you  make  fields 
in  one  class  too  accessible  to  other  classes.  That’s  why  you  should  only  make  fields 
and  methods  public  if  you  need  to.  Since  the  Cow  Calculator  never  updates 
FeedMultiplier,  there’s  no  need  to  allow  any  other  class  to  set  it.  So  let’s  change  it 
to  a  read-only  automatic  property. 


o 


Remove  this  line  from  your  program: 

public  const  int  FeedMultiplier  =  30; 

Use  prop-tab-tab  to  add  a  read-only  automatic  property: 

public  int  FeedMultiplier  {  get;  private 


set;  } 


his  teWato  7  ad-b 
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cad  be  value  ot  FeedAl^or- 
Jut  sinde  its  set  is  f'r.vate,  that 
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Go  ahead  and  make  that  change  to  your  code.  Then  run  it.  Uh-oh — something’s  wrong! 
BagsOfFeed  always  returns  0  bags! 

Wait,  that  make  sense.  FeedMultiplier  never  got  initialized.  It  starts  out  with  the 
default  value  of  zero  and  never  changes.  When  it’s  multiplied  by  the  number  of  cows,  it  still 
gives  you  zero.  So  add  an  object  initializer: 

public  Forml ( )  { 

InitializeComponent ( ) ; 

farmer  =  new  Farmer ( )  {  NumberOfCows  =  15,  FeedMultiplier  =30  }; 


Uh-oh — the  program  won’t  compile!  You  should  get  this  error: 


You  can  only  initialize  public  fields  and  properties  inside  an  object  initializer. 
So  how  can  you  make  sure  your  object  gets  initialized  properly  if  some  of 
the  fields  that  need  to  be  initialized  are  private? 
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Use  a  constructor  to  initialize  private  fields 


All  you  have  to  do  to 
add  a  constructor 
to  a  class  is  add  a 
method  that  has  the 
same  name  as  the 
class  and  no  return 
value. 


If  you  need  to  initialize  your  object,  but  some  of  the  fields  that  need  to  be  initialized  are  private, 
then  an  object  initializer  just  won’t  do.  Luckily,  there’s  a  special  method  that  you  can  add  to  any 
class  called  a  constructor.  If  a  class  has  a  constructor,  then  that  constructor  is  the  very  first 
thing  that  gets  executed  when  the  class  is  created  with  the  new  statement.  You  can  pass 
parameters  to  the  constructor  to  give  it  values  that  need  to  be  initialized.  But  the  constructor 
does  not  have  a  return  value,  because  you  don’t  actually  call  it  directly  You  pass  its 
parameters  to  the  new  statement.  And  you  already  know  that  new  returns  the  object — so 
there’s  no  way  for  a  constructor  to  return  anything. 

Q  Add  a  constructor  to  your  Farmer  class 

This  constructor  only  has  two  lines,  but  there’s  a  lot  going  on  here.  So  let’s  take  it  step  by  step. 

We  already  know  that  we  need  the  number  of  cows  and  a  feed  multiplier  for  the  class,  so  we’ll 
add  them  as  parameters  to  the  constructor.  We  ll  change  feedMultiplier  from  a  const  to 
an  int.  We’ll  need  a  value  for  it,  so  let’s  make  sure  it  gets  passed  into  the. constructor.  We’ll  use 
the  constructor  to  set  the  number  of  cows,  too..  lnCe  we  C  ange  eedMultiplier  from  a  public,  Const  -to  a 

.  .  .  .  ~  ...  .  .  .  .  private  int  tield,  we  changed  its  name  so  it  starts  with  a 

rxvate  int  feedMultiplier ;  *{*  Tlrf  ’  tty  sUi3rd  ^ 

Notice  how  „  ...  .  ^  you  II  se^  throuj^jout 


Well  change 
-feedMultiplier 
-from  a  Const  "to 
an  int  field- 


there's  no 
u.  , 
ov  mt  ov 

another  type 

after  "public  ■ 

That's  because 

Constructors 

don't  ha^e  a 
return  value- 


> 

void 


:ee 


public  Farmer (int  numberOf Cows ,  int 

this . feedMultiplier  =  feedMultiplier; 
NumberOf Cows  =  numberOf Cows ; 

}  If  we  just  set  the  private~numberOf  Cows  field,  the  NumberOf  Cows  set  accessor 
would  never  be  called-  Setting  NumberOfCows  makes  sure  its  called- 


iplier)  { 

]>e  fi^  thing  wel!  do  is  set 
the  teed  multiplier,  because  it 

MU  M.«WfCo«S 

accessor. 


This  is  the  error 
you’ll  get  if  your 
Constructor 
takes  parameters 
but  your  new 
doesn't  have  any- 


Error  List 

0 

|  Q  1  Error 

l\  0  Warnings 

1)  0  Messages 

 -1 

Description 

File  Line  Column 

lo  1  1  Cow  Calculator. Farmer1  does  not  contain  a  constructor  Forml.cs  18  22 

stakes  'O-arguments 

(3)  Now  change  the  form  so  that  it  uses  the  constructor 

The  only  thing  you  need  to  do  now  is  change  the  form  so  that  the  new  statement  that 
creates  the  Farmer  object  uses  the  constructor  instead  of  an  object  initializer. 


public  Forml ( )  { 

InitializeComponent ( )  ; 
farmer  =  new  Farmer (15, 

}  Here's  where  -the  new  statement  calls  -the  Construe. 

like  any  other  new  statement,  except  that  it  has  parameters  that 

a  tw  constn.ew  -aw-  y»  ~ 

J  th,  W-F-*  ^  j“t  olktr  ■*thod- 


|t  looks  just 


You  already  know  that  the 
form  is  an  object-  Well,  it's  got 
a  Constructor  tool  Thats  what 
this  method  is- — notice  how  it  s 
named  Forml  (like  the  class) 
and  it  doesn't  have  a  return 
value- 


you  are  here  ► 
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constructors  deconstructed 


Constructors 
\v'ay  lip  Close 


Cohstrud-fcov-s  don'-t 
ve-tuv-n  anything,  so 
there's  no  return  type- 


Let's  take  a  closer  look  at  the  Farmer  constructor  so  we  can  get  a  good  sense 
of  what's  really  going  on. 


This  donstrudtor  has  two  parameters,  wbifcb  work  just  like 
ordinary  parameters.  The  first  one  gives  the  number  of  tows, 
and  the  second  one  is  the  -feed  multiplier- 


private 


♦ 


int  feedMultiplier; 


public  Farmer (int  numberOf Cows ,  int 

this . feedMultiplier  =  feedMultiplier; 


NumberOf Cows  =  numberOf Cows ; 

,  We  need  a  way  to  differentiate  the  field  called 
■*feedA1ultiplier  from  the  parameter  with  the 
same  name-  That's  where  the  "this."  keyword 
Comes  in  really  handy. 


feedMultiplier)  { 

r - We  neecf  to  set  the  feed  multiplier  first 

because  the  second  statement  calls  the 
NumberOf  Cows  set  accessor,  which  needs 
feedAlultiplier  to  have  a  value  in  order  to 
set  BagsOf  Feed 

Since  "this"  is  always  a  reference  to  the  Current  object  this. feedMultiplier 
refers  to  the  field-  If  you  leave  "this"  off,  then  feedMultplier  refers 
to  the  parameter.  So  the  first  line  in  the  Constructor  sets  the  private 
feedMultplier  field  egual  to  the  second  parameter  of  the  Constructor- 


tliorejare  no 

Dumb  Questions 


Vi-  Is  it  possible  to  have  a  constructor  without  any 
parameters? 

Yes.  It’s  actually  very  common  for  a  class  to  have  a 
constructor  without  a  parameter.  In  fact,  you've  already  seen  an 
example  of  it— your  form’s  constructor.  Look  inside  a  newly 
added  Windows  form  and  find  its  constructor's  declaration: 

public  Forml()  { 

InitializeComponent ()  ; 

} 

That’s  the  constructor  for  your  form  object.  It  doesn't  take 
any  parameters,  but  it  does  have  to  do  a  lot.  Take  a  minute 
and  open  up  Forml .  Designer .  cs.  Find  the 
InitializeComponent  ( )  method  by  clicking  on  the  plus 
symbol  next  to  “Windows  Form  Designer  generated  code”. 

That  method  initializes  all  of  the  controls  on  the  form  and  sets 
all  of  their  properties.  If  you  drag  a  new  control  onto  your  form 
in  the  IDE's  form  designer  and  set  some  of  its  properties  in  the 
Properties  window,  you'll  see  those  changes  reflected  inside  the 

InitializeComponent  ( )  method. 


The  InitializeComponent  ( )  method  is  called  inside 
the  form's  constructor  so  that  the  controls  all  get  initialized  as 
soon  as  the  form  object  is  created.  (Remember,  every  form  that 
gets  displayed  is  just  another  object  that  happens  to  use  methods 
that  the  .NET  Framework  provides  in  the  System. Windows. Forms 
namespace  to  display  windows,  buttons  and  other  controls.) 


Watch  it! 


When  a  method’s  parameter 
has  the  same  name  as  a 
field,  then  it  masks  the 
field. 


Did  you  notice  how  the 
constructor’s  numberOf  Cows  parameter 
looks  just  like  the  backing  field  behind  the 
NumberOfCows  property?  If  you  wanted  to  use 
to  the  backing  field  in  of  the  constructor,  you’d 
use  “this .  ” — numberOf  Cows  refers  to  the 
parameter,  and  this .  numberOf  Cows  is  how 
you’d  access  the  private  field. 
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Dumb  Questions 


Why  would  I  need  complicated 
logic  in  a  get  or  set  accessor?  Isn’t  it  just 
a  way  of  creating  a  field? 

Because  sometimes  you  know  that 
every  time  you  set  a  field,  you'll  have  to  do 
some  calculation  or  perform  some  action. 
Think  about  Kathleen's  problem— she 
ran  into  trouble  because  the  form  didn’t 
run  the  method  to  recalculate  the  cost  of 
the  decorations  after  setting  the  number 
of  people  in  the  DinnerParty  class.  If  we 
replaced  the  field  with  a  set  accessor,  then 
we  could  make  sure  that  the  set  accessor 
recalculates  the  cost  of  the  decorations.  (In 
fact,  you're  about  to  do  exactly  that  in  just  a 
couple  of  pages!) 


Wait  a  minute— so  what’s  the 
difference  between  a  method  and  a  get  or 
set  accessor? 

There  is  none!  Get  and  set  accessors 
are  a  special  kind  of  method— one  that  looks 
just  like  a  field  to  other  objects,  and  called 
whenever  that  field  is  set.  Get  accessors 
always  return  a  value  that’s  the  same  type 
as  the  field,  and  set  accessors  always  take 
exactly  one  parameter  called  value 
whose  type  is  the  same  as  the  field.  Oh, 
and  by  the  way,  you  can  just  say  “property” 
instead  of  “get  and  set  accessor”. 


O:  So  you  can  have  ANY  kind  of 
statement  in  a  property? 


Absolutely.  Anything  you  can  do  in  a 
method,  you  can  do  in  a  property.  They  can 
call  other  methods,  access  other  fields,  even 
create  objects  and  instances.  But  they  only 
get  called  when  a  field  gets  accessed,  so  it 
doesn't  make  sense  to  have  any  statements 


in  them  that  don’t  have  to  do  with  getting  or 
setting  the  field. 

O:  If  a  set  accessor  always  takes  a 
parameter  called  value,  why  doesn’t  its 
declaration  have  parentheses  with  “int 
value”  in  them,  like  you’d  have  with 
any  other  method  that  takes  a  parameter 
called  value? 

Because  C#  was  built  to  keep  you  from 
having  to  type  in  extra  information  that  the 
compiler  doesn't  need.  The  parameter  gets 
declared  without  you  having  to  explicitly  type 
it  in,  which  doesn't  sound  like  much  when 
you're  only  typing  one  or  two— but  when  you 
have  to  type  a  few  hundred,  it  can  be  a  real 
time  saver  (not  to  mention  a  bug  preventer). 


Every  set  accessor  always  has  exactly  one 
parameter  called  value,  and  the  type  of 
that  parameter  always  matches  the  type  of 
the  field.  C#  has  all  the  information  it  needs 
about  the  type  and  parameter  as  soon  as 
you  type  “set  {”.  So  there's  no  need  for 
you  to  type  any  more,  and  the  C#  compiler 
isn’t  going  to  make  you  type  more  than  you 
have  to. 


(Q  Wait,  a  sec— is  that  why  I  don’t  add 
a  return  value  to  my  constructor? 


Exactly!  Your  constructor  doesn't  have 
a  return  value  because  every  constructor 
is  always  void.  It  would  be  redundant  to 
make  you  type  “void”  at  the  beginning  of 
each  constructor,  so  you  don't  have  to. 


%  Can  I  have  a  get  without  a  set  or  a 
set  without  a  get? 


Yes!  When  you  have  a  get  accessor 
but  no  set,  you  create  a  read-only  field.  For 
example,  the  SecretAgent  class  might  have 
a  Readonly  field  for  the  name: 

string  name  =  "Dash  Martin"; 
public  string  Name  { 
get  {  return  name;  } 

} 

And  if  you  create  a  property  with  a  set 
accessor  but  no  get,  then  your  field  can  only 
be  written,  but  not  read.  The  SecretAgent 
class  could  use  that  for  a  Password  field  that 
other  spies  could  write  to  but  not  see: 

public  string  Password  { 
set  { 

if  (value  ==  secretCode)  { 
name  =  "Herb  Jones"; 

} 

} 

Both  of  those  techniques  can  come  in  really 
handy  when  you're  doing  encapsulation. 


Properties  (get  and 
set  accessors)  are 
a  special  kind  of 
metliod  that’s  only 
run  when  anotker 
class  reads  or 
writes  a  property. 
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what’s  in  a  name? 


Take  a  look  at  the  get  and  set  accessors  here.  The  Form  that  is  using 
this  class  has  a  new  instance  of  CableBill  called  thisMonth  and  calls 
the  GetThisMonthsBill  ()  method  with  a  button  click.  Write  down  the 
value  of  the  amountOwed  variable  after  the  code  below  executed. 


public  class  CableBill  { 
private  int  rentalFee; 
public  CableBill ( int  rentalFee)  { 
this . rentalFee  =  rentalFee; 
discount  =  false; 

} 


private  int  payPerViewDiscount; 
private  bool  discount; 
public  bool  Discount  { 
set  { 

discount  =  value; 
if  (discount) 
payPerViewDiscount  =  2; 
else 

payPerViewDiscount  =  0; 

} 

} 


public  int  CalculateAmount ( int  payPerViewMoviesOrdered)  { 

return  (rentalFee  -  payPerViewDiscount)  *  payPerViewMoviesOrdered; 

} 


1. 


2. 


CableBill  january  =  new  CableBill (4) ; 

MessageBox . Show ( j  anuary . CalculateAmount ( 7 )  . ToString ( ) ) ; 

CableBill  february  =  new  CableBill ( 7 ) ; 
february . payPerViewDiscount  =  1; 

MessageBox . Show ( february. CalculateAmount (3 ) . ToString ( ) ) ; 


What's  the  value  of 
amountOwed? 


What's  the  value  of 
amountOwed? 


3.  CableBill  march  =  new  CableBill ( 9 ) ; 
march . Discount  =  true; 

MessageBox . Show (march . CalculateAmount ( 6 ) . ToString ( ) ) ; 


What's  the  value  of 
amountOwed? 
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Dumb  Questions 


•  I  noticed  that  you  used  uppercase 
names  for  some  fields  but  lowercase 
ones  for  others.  Does  that  matter? 

Yes— it  matters  to  you.  But  it  doesn't 
matter  to  the  compiler.  C#  doesn't  care  what 
you  name  your  variables,  but  if  you  choose 
weird  names  then  it  makes  your  code  hard 
to  read.  Sometimes  it  can  get  confusing 
when  you  have  variables  that  are  named  the 
same,  except  one  starts  with  an  uppercase 


letter  and  the  other  starts  with  a  lowercase 
one. 

Here  are  a  few  tips  about  variable  names 
to  help  you  keep  it  straight.  They're  not 
hard-and-fast  rules— the  compiler  doesn't 
care  whether  a  variable  is  uppercase  or 
lowercase— but  they're  good  suggestions  to 
help  make  your  code  easier  to  read. 

1 .  When  you  declare  a  private  field,  it  should 
be  in  camelCase  and  start  with  a  lowercase 
letter.  (It's  called  camelCase  because  it 
starts  with  a  lowercase  letter  and  additional 
words  are  uppercase,  so  they  resemble 
humps  on  a  camel.) 


encapsulation 

2.  Public  properties  and  methods  are  in 
PascalCase  (they  start  with  an  uppercase 
letter). 

3.  Parameters  to  methods  should  be  in 
camelCase. 

4.  Some  methods,  especially  constructors, 
will  have  parameters  with  the  same  names 
as  fields.  When  this  happens,  the  parameter 
masks  the  field,  which  means  statements 

in  the  method  that  use  the  name  end  up 
referring  to  the  parameter,  not  the  field.  Use 
the  this  keyword  to  fix  the  problem— add 
it  to  the  variable  to  tell  the  compiler  you're 
talking  about  the  field,  not  the  parameter. 


This  code  has  problems.  Write  down  what  you  think  is  wrong  with 
the  code,  and  what  you'd  change. 


class  GumballMachine  { 

private  int  gumballs; 


private  int  price; 
public  int  Price 
{ 


get 

{ 


public  string  DispenseOneGumball (int  price,  int  coinslnserted) 
{ 


if  (this . coinslnserted  >=  price)  {  //  check  the  field 
gumballs  -=  1; 

return  "Here's  your  gumball"; 

}  else  { 

return  "Please  insert  more  coins"; 


} 


} 


} 
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encapsulation  prevents  bugs 


r  /  r  r — 

Solution 


Write  down  the  value  of  the  amountOwed  variable  after  the  code 
below  executed. 


1.  CableBill  january  =  new  CableBill (4) ; 

MessageBox . Show ( j  anuary . CalculateAmount (7 )  . ToString  ( ) ) 

2.  CableBill  february  =  new  CableBill  (7) ; 
february .payPerViewDiscount  =  1; 

MessageBox . Show (february . CalculateAmount ( 3) . ToString ( ) 

3.  CableBill  march  =  new  CableBill ( 9) ; 
march . Discount  =  true; 

MessageBox . Show (march . CalculateAmount ( 6 )  . ToString ( ) )  ; 


What's  the  value  of 
amountOwed? 
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What's  the  value  of 
amountOwed? 

won’t  4om pile 


What's  the  value  of 
amountOwed? 


M 


■parpen  your  pencil 
Solution 


This  code  has  problems.  Write  down  what  you  think  is  wrong  with 
the  code,  and  what  you'd  change. 


The  “this"  keyword 
is  or,  a  parameter, 
where  it  doesn  t 
belong.  It  should  be 
on  price,  betause 
that  -field  is  masked 
by  a  parameter. 


if  (this . coinslnserted  >=  price) 
gumballs  -=  1; 
return  "Here's  your  gumball 


}  else  { 


{  //  check  the  field 


return  "Please  insert  more  coins' 
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Use  what  you've  learned  about  properties  and  constructors  to  fix  Kathleen's  Party  Planner 
program. 


O 


How  to  fix  the  Dinner  Party  calculator 

If  we  want  to  fix  the  DinnerParty  class,  we’ll  need  a  way  to  make  sure  that  the 

CalculateCostOfDecorations  ( )  method  gets  called  every  time  that  NumberOfPeople  changes. 


o 


NumberOfPeople 


=  10; 


CalculateCost  ()  returns  $650 


Add  properties  and  a  constructor 


^erPoX*^ 

l-P  we  make  sure  -that  the  dost  o-P  the 
dedov-atiohs  is  redaldulated  every  time 
the  number  ot  people  is  updated,  then 
CaldulateCostO  will  always  return  the 
right  amount- 


All  you  need  to  do  to  fix  Kathleen’s  problem  is  make  sure  the  DinnerParty  class  is  well- 
encapsulated.  You’ll  start  by  changing  NumberOfPeople  to  a  property  that  always  calls 
CalculateCostOfDecorationsO  any  time  it’s  called.  Then  you’ll  add  a  constructor  that  makes 
sure  the  instance  is  initialized  properly.  Finally,  you’ll  change  the  form  so  it  uses  the  new 
constructor.  If  you  do  this  right,  that’s  the  only  change  you’ll  need  to  make  to  the  form. 


★  You’ll  need  to  create  a  new  property  for  NumberOfPeople  that  has  a  set  accessor 
which  calls  CalculateCostOfDecorations  ( )  .  It’ll  need  a  backing  field  called 
numberOf People. 

★  The  NumberOfPeople  set  accessor  needs  to  have  a  value  to  pass  as  the  parameter  to 
the  CalculateCostOfDecorations  ( )  method.  So  add  a  private  bool  field  called 
fancyDecorations  that  you  set  every  time  CalculateCostOfDecorations  ( )  is 
called. 


★  Add  a  constructor  that  sets  up  the  class.  It  needs  to  take  three  parameters  for  the  Number 
of  People,  Healthy  Option,  and  Fancy  Decorations.  The  form  currently  calls  two  methods 
when  it  initializes  the  DinnerParty  object — move  them  into  the  constructor. 
dinnerParty . CalculateCostOfDecorations ( fancyBox . Checked) ; 
dinnerParty . SetHealthyOption (healthyBox . Checked) ; 

★  Here’s  the  constructor  for  the  form — everything  else  in  the  form  stays  the  same: 
public  Forml()  { 

InitializeComponent ( ) ; 

dinnerParty  =  new  DinnerParty ( (int) numericUpDownl .Value, 

healthyBox . Checked,  fancyBox . Checked) ; 
DisplayDinnerPartyCost ( ) ; 

1 
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ExenciSe 

Solution 


Use  what  you’ve  learned  about  properties  and  constructors  to  fix  Kathleen’s  Party  Planner 
program. 


public  class  DinnerParty  { 

const  int  CostOf FoodPerPerson  =  25; 

private  int  numberOf People; 
public  int  NumberOf People  { 

get  {  return  numberOf People;  } 
set  { 

numberOf People  =  value; 

CalculateCostOf Decorations ( fancyDecorations ) 

} 

} 

private  bool  fancyDecorations; 

public  decimal  CostOfBeveragesPerPerson; 
public  decimal  CostOf Decorations  =  0; 


Now  -that  numberOfPeople  is  private,  there's 
no  way  -for  the  -form  to  change  it  without 
also  recalculating  the  Cost  o-f  the  decorations. 
That'll  fi*  the  bug  that  almost  Cost  Kathleen 
one  o-f  her  best  clients^  > 

■  f 

By  usmg  a  property,  you  can  make 
sure  that  the  Cost  o+  decorations  is 
recalculated  every  time  the  number 
o-f  people  changes. 


public  DinnerParty ( int  numberOf People,  bool  healthyOption,  bool  fancyDecorations)  { 
this . NumberOf People  =  numberOfPeople; 
this . fancyDecorations  =  fancyDecorations; 

SetHealthyOption (healthyOption) ; 

CalculateCostOf Decorations (fancyDecorations) 

} 


public  void  SetHealthyOption (bool  healthyOption) 
if  (healthyOption)  { 

CostOfBeveragesPerPerson  =  5.00M; 

}  else  {  Make 

CostOfBeveragesPerPerson  =  20.00M; 


Be  careful  how  you 
use  "this  ”.  Make  sure 
you  put  it  in 

Kum  berOfPeople  so  that  it 
*  calls  the  set  accessor. 


} 


sure  you  store  the 
+ancy  deconations  m  a  -field 

}  50  Number^- fPeople  set 

accessor  can  use  it.  \ 

public  void  CalculateCostOf Decorations (bool  fancy)  { 


} 


fancyDecorations 
if  (fancy)  { 

CostOf Decorations 
}  else  { 

CostOf Decorations 

} 


fancy; 


(NumberOfPeople 

(NumberOfPeople 


15.00M)  +  50M; 
7.50M)  +  30M; 


And  you'll  need  to 
put  it  in  -front  of 
"fancyDecorations” 
because  the 
fancyDecorations 
parameter  masks 
the  private  f  ield 
with  the  same 
name- 


public  decimal  CalculateCost (bool  healthyOption)  { 
decimal  totalCost  =  CostOfDecorations 

t  ( (CostOfBeveragesPerPerson  +  CostOf FoodPerPerson) 

if  (healthyOption)  { 

return  totalCost  *  . 95M; 

}  else  { 

return  totalCost; 

} 


NumberOfPeople) ; 
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'$4' 

+  Your  object’s  family  tree 


So  there  I  was  riding  my  bicycle 
object  down  dead  man's  curve 
when  I  realized  it  inherited  from 
TwoWheeler  and  I  forgot  to  add  a 
Brakes()  method...long  story  short, 
twenty-six  stitches  and  Mom  said  I'm 
grounded  for  a  month. 


Sometimes  you  DO  want  to  be  just  like  your  parents. 

Ever  run  across  an  object  that  almost  does  exactly  what  you  want  your  object  to  do? 
Found  yourself  wishing  that  if  you  could  just  change  a  few  things,  that  object  would 
be  perfect?  Well  that’s  just  one  reason  that  inheritance  is  one  of  the  most  powerful 
concepts  and  techniques  in  the  C#  language.  Before  you’re  through  this  chapter,  you'll 
learn  how  to  subclass  an  object  to  get  its  behavior,  but  keep  the  flexibility  to  make 
changes  to  that  behavior  You’ll  avoid  duplicate  code,  model  the  real  world  more 
closely,  and  end  up  with  code  that's  easier  to  maintain 


this  is  a  new  chapter 


205 


happy  birthday  baby 


Kathleen  does  birthday  parties,  too 

Now  that  you  got  your  program  working,  Kathleen  is  using  it  all  the 
time.  But  she  doesn’t  just  handle  dinner  parties — she  does  birthdays 
loo,  and  they’re  priced  a  little  differently.  She'll  need  you  to  add 
birthdays  to  her  program. 


^  U*  Ch^es 

have  {o  do  £3j(es 
a*d  wei'tinj. 


These  are  both  the  same 
as  the  dinner  party. 


Cost  Estimate  for  a  Birthday  Party 

$25  per  person 

There  are  two  options  for  the  cost  of  decorations  If  a  dent 
qoes  with  the  normal  decorations,  it’s  $1.50  per  person  with  a  $  iQ 
decorating  fee  A  client  can  also  upgrade  the  party  decorations 
to  the  Taney  Option'-that  costs  f  1 5  per  person  with  a  $5' 0  one¬ 
time  decorating  fee 

When  the  perty  has  four  people  or  less,  use  an  8-inch  cake  ($H0). 
Otherwise  she  uses  a  1 6-inch  cake  ($75). 

Writinq  on  the  cake  costs  $.25  for  each  letter.  The  8-inch  cake  can 
have  up  to  16  letters  of  writing,  and  the  16-inch  one  can  have  up 
to  *f0  letters  of  writing. 

The  explication  should  handle  both  types  of  parties  Ose  a  tab  control 
one  tab  for  each  kind  of  party. 
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We  need  a  PirthdayParty  class 


Modifying  your  program  to  calculate  the  cost  of  Kathleen’s 
birthday  parties  means  adding  a  new  class  and  changing  the 
form  to  let  you  handle  both  kinds  of  parties. 


Here's  what  we  need  to  do: 


You'll  do  all  -this  in  a 
minute— but  -first  you'll 
./•  ' need  to  jet  a  sense  of 

what  the  iob  involves. 


Q)  Create  a  new  Bir+hdayParty  class 

Your  new  class  w  ill  need  to  calculate  the  costs,  deal  with 
decorations,  and  check  the  size  of  the  writing  on  the  cake. 


Add  a  TabControl  to  your  form 

Each  tab  on  the  form  is  a  lot  like  the  GroupBox  control  you  used 
to  show  how  much  cash  Joe  and  Bob  had  back  in  Chapter  3.  Just 
click  on  the  tab  you  want  to  display,  and  drag  controls  into  it. 


Birthday  Party 

NumberOfPeople 

CostOfDecorations 

CakeSize 

CakeWriting 

CalculateCostOfDecorationsO 

CalculateCostO 


Label  the  first  tab  and  move  the  Dinner  Party  controls  onto  it 

You’ll  drag  each  of  the  controls  that  handle  the  dinner  party  into  the  newr  tab. 
They’ll  work  exactly  like  before,  but  they'll  only  be  displayed  when  the  dinner 
party  tab  is  selected. 

Label  the  second  tab  and  add  new  Birthday  Party  controls  onto  it 

You'll  design  the  interface  for  handling  birthday  parties  just  like  you  did  for  the 
dinner  parties. 

Wire  your  birthday  party  class  up  to  the  controls 

Now  all  you  need  to  do  is  add  a  BirthdayParty  reference  to  the  form’s  fields,  and  add 
the  code  to  each  of  your  new  controls  to  so  that  it  uses  its  methods  and  properties. 


tl lerejcffe  no 

Durrjb  Questions 


Oj 

Why  can’t  we  just  create  a  new  instance  of  DinnerParty, 
like  Mike  did  when  he  wanted  to  compare  three  routes  in  his 
navigation  program? 

Because  if  you  created  another  instance  of  the  DinnerParty 
class,  you'd  only  be  able  to  use  it  to  plan  extra  dinner  parties.  Two 
instances  of  the  same  class  can  be  really  useful  if  you  need  to 
manage  two  different  pieces  of  the  same  kind  of  data.  But  if  you  need 
to  store  different  kinds  of  data,  you’ll  need  different  classes  to  do  it. 


Q„:  How  do  I  know  what  to  put  in  the  new  class? 

Before  you  can  start  building  a  class,  you  need  to  know 
what  problem  it’s  supposed  to  solve.  That's  why  you  had  to  talk  to 
Kathleen— she's  going  to  be  using  the  program.  Good  thing  you  took 
a  lot  of  notes!  You  can  come  up  with  your  class's  methods,  fields,  and 
properties  by  thinking  about  its  behavior  (what  it  needs  to  do)  and  its 
state  (what  it  needs  to  know) 


you  are  here  > 
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another  kind  of  party 


Add  birthday  parties  to  Kathleen’s  party  planning  program. 


/Wake  sure  you  use  decimal  as 
the  type  -for  the  -fields  and 
properties  that  hold  Currency 


Add  the  new  BirthdayParty  class  to  your  program 

You  already  know  how  you'll  handle  the  NumbcrOfPeoplc  property  and 
the  CostOfDet  orations  methods — they’re  just  like  their  counterparts  in 
Dinnerparty.  Start  by  creating  your  new  class  and  adding  those.  Then 
add  the  rest  of  the  behavior: 


|f  the  take 
writing  is  too  lon$ 
for  the  take,  the 
set  attessor  tuts 
the  batkin^  f  >eld 
down  to  site 
So  you’ll  need 
to  make  sure  to 
reload  the  te*t 
into  the  tent 
bo*  every  time 
the  te*t  thanks 

or  the  number  ★ 
of  people  thanks 
(in  tase  there’s 
a  lon$  string  and 
she  tuts  down  to  * 
a  smaller  take) 


Add  a  GakeSize  integer  property.  Make  a  private  method 
called  CalculatcCakeSizeQ  that  sets  GakeSize  to  either  8  or  16 
depending  on  the  number  of  people.  You’ll  need  to  call  it  from 
the  constructor  and  the  Numbert  JfPeople  set  accessor. 

You’ll  need  a  CakeWriting  string  property  to  hold  the  writing 
on  the  cake.  We’ll  give  you  the  code  for  this  one. 

The  CakeWriting  set  accessor  checks  GakeSize  because 
different  sizes  of  cake  can  hold  different  numbers  of  letters. 
Then  it  uses  value .  Length  to  check  how  long  the  string 
is.  If  it’s  too  long,  instead  of  setting  the  private  field,  the  set 
accessor  pops  up  a  message  box  that  says,  “Too  many  letters 
for  a  1 6-inch  cake”  (or  8-inch  cake). 

Every  string  has  a  Substring  ( )  method  that  returns  a 
portion  of  the  string.  CakeWriting  uses  it  to  cut  the  size  of 
the  cake  writing  down — if  the  number  of  people  changes  and 
reduces  the  cake  size,  you'll  need  to  cut  down  the  string,  too. 

Finally,  add  the  CalculateCostQ  method.  But  instead  of  taking 
the  decoration  cost  and  adding  the  cost  of  beverages  (which  is 
what  happens  in  DinnerParty),  it'll  add  the  cost  of  the  cake. 


BirthdayParty 


NumberOfPeople 

CostOfDecorations 

CakeSize 

CakeWriting 


CalculateCostOfDecorations() 

CalculateCost() 


We  don  t  want  any  other 
methods  Changing  the 
value  of  CakeWritihjj. 


Clidk  on  the  tabs  to  switch 
between  them  Mse  the 
TabColledtion  property  to 
change  the  te*t  for  eadh 
tab  Click  the  button 
ne*t  to  it  and  seledt  eadh 
tab’s  Te*t  property 


Update  the  form  to  add  tabs 

Drag  a  TabControl  out  of  the  toolbox  and  onto  your  form,  and  resize 
it  so  it  takes  up  the  entire  form.  Change  the  text  of  each  tab  using  the 
TabPages  property  :  a  “...”  button  shows  up  in  the  Properties  Window 
next  to  the  property.  When  you  click  it,  the  IDF  pops  up  a  window 
that  lets  you  edit  the  properties  of  each  tab.  Set  the  Text  property  of 
the  tabs  to  “Dinner  Party”  and  “Birthday  Party”. 


Name  the  first  tab  and  move  the  Dinner  Party 
controls  onto  it 

You’ll  drag  the  each  of  the  controls  that  handle  the  dinner 
party  into  the  new  tab.  They’ll  work  exactly  like  they  do  now; 
but  they  ’ll  only  be  displayed  when  that  tab  is  selected. 


*  Party  Planner 


Dinner  Party  Birthday  Party  I 

Number  of  People 

i 


0  Fancy  decorations 
0  Healthy  Option 

Cost  1350  00 


A-Cter  you  dra<j  -the  Dinner 
Party  Controls  onto  the  tab, 
they’ll  only  be  visible  when  the 
Dinner  Party  tab  is  selected 
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Build  the  Birthday  Party  user  interface 

The  Birthday  Party  fil  l  has  a  NumericUpDovvn  control  for  the  number  of  people,  a 
GheckBox  control  for  fancy  decorations,  and  a  Label  control  with  a  3D  border  for  the  cost. 
Then  you'll  add  a  TextBox  control  for  the  cake  writing. 


This  lab  uses  the 
NumCvidMpDown,  ChetkBox; 
and  Label  tonlrols  just  like 
the  pinner  Party  tab  does. 
Ka«ne  them  number  Birthday 
tantyBirthday,  and 
birthdayCost 


o 


Party  Planner 


Dinner  Party  Birthday  Pe 
Number  of  People 

Is  ; 


1^1  Fancy  Decorations 


!  Cake  Writing 

I  Happy  Birthday 

□ 

Cost  $ 

Click  on  the  Birthday  Party 
tab  and  add  the  new  Controls. 

Add  a  Text  Box  Control  called 
CakeliVnting  tor  the  writing 
on  the  cake  (and  a  label  above 
'  it  so  the  user  knows  what  it’s 
tor).  Use  its  Text  property 
+0  give  it  a  detault  value  ot 
'Happy  Birthday". 


Did  you  notice  how 
we  lett  out  some 
ot  the  brackets? 
When  you  only  have 
one  statement  in  a 
code  block,  you  don’t 
need  to  add  Curly 
brackets  around  it 


This  property  is  a  little  more  Complex  than  the  ones 
you’ve  seen  betore.  It  checks  the  cake  size  to  see  it  it’s 
too  long  tor  the  cake,  using  the  maxLength  variable  to 
store  the  maximum  length  It  it’s  too  long,  it  gives  an 
error  message  and  then  Cuts  the  backing  tield  down  to 
the  right  size,  so  it  Can  be  reloaded  into  the  text  box. 


+  CakeSize  +  "  inch  cake"); 


O 


You’ll  need  this  property 

Here’s  the  code  for  the  BirthdavParty.  CakeWriting  property — it'll  come  in  handy: 

private  string  cakeWriting  = 

public  string  CakeWriting  {  - 

get  {  return  this .cakeWriting;  ) 
set  { 

int  maxLength; 
if  (CakeSize  =  8) 
maxLength  =  16; 

else 

maxLength  =  40; 

(value. Length  >  maxLength)  { 

MessageBox. Show ("Too  many  letters  for  a  1 
if  (maxLength  >  this .cakeWriting. Length) 
maxLength  =  this. cakeWriting. Length; 
this. cakeWriting  =  cakeWriting. Substring (0,  maxLength); 

Every  string  has  a  SubstringO  method  that  returns  a 
portion  ot  the  string.  This  one  Cuts  it  down  to  the 
allowed  length,  so  you’ll  need  to  reload  the  writing  into 
the  textbox  when  the  text  or  cake  site  cKanae 

Put  it  all  together 

All  the  pieces  arc  there,  now  it’s  just  a  matter  of  writing  a  little  code  to  make  the  controls  w  ork. 

*  Add  a  BirthdayParty  object  to  the  form.  Make  sure  you  instantiate  it. 

*  Add  code  to  the  Numeric UpDown  control’s  event  handler  method  to  set  the  object’s 
NumberOfBeople  property. 

♦  Make  the  Fancy  Decorations  checkbox  work. 

★  Add  a  DisplavBirthdayPartyCostQ  method  and  add  it 
to  all  of  the  event  handlers  so  the  cost  label  is  updated 
automatically  any  time  there’s  a  change. 


if 


1 

else 


1 


this. cakeWriting  =  value; 


Run  it 

Make  sure  the  program  works  the  way  it’s  supposed  to.  Check  that  it 
pops  up  a  message  box  if  the  writing  is  too  long  for  the  cake.  Make 
sure  the  price  is  always  right.  Once  it’s  working,  you’re  done! 


*  Party  Planner 


[  Dinner  Party  Birthday  Party 
Number  of  People 


M  Fancy  Decorations 
Cake  Writing 


Happy  birthday  Myrtle! 


Cost  8410  50 
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Add  birthday  parties  to  Kathleen's  party  planning  program. 

THe  BirthdayParty  is 

public  partial  class  Forml  :  Form  { 

Dinnerparty  dinnerparty;  /  .  ,  ^  m^te  of  pWmerParty 

BirthdayParty  birthdayParty;  I  ^ 

public  Forml  ()  {  v[ 

InitializeComponent () ;  X/ 

dinnerparty  =  new  DinnerParty( (int) numericUpDownl . Value, 

healthyBox. Checked,  fancyBox. Checked) ; 
DisplayDinnerPartyCost () ; 


birthdayParty  =  new  BirthdayParty ( (int) numberBirthday. Value, 
fancyBirthday. Checked,  cakeWriting. Text) ; 
DisplayBirthdayPartyCost () ; 

) 


//  The  fancyBox,  healthyBox,  and  numericUpDownl  event  handlers  and 
//  the  DisplayDinnerCost  ()  method  are  identical  to  the  ones  in  the 
//  Dinner  Party  exercise  at  the  end  of  Chapter  5. 


private  void  numberBirthday_ValueChanged (object  sender,  EventArgs  e)  ( 
birthdayParty. NumberOf People  =  (int) numberBirthday. Value; 
DisplayBirthdayPartyCost ( ) ; 

I  —  The  ChedkBox  and  NumeridUpDown  don't*- oh1  event: 

handlers  a*-e  just  like  the  ones  for  the  dinner  party 

private  void  fancyBirthday_CheckedChanged (object  sender,  EventArgs  e)  { 
birthdayParty .CalculateCostOf Decorat ions (fancyBirthday .Checked) ; 
DisplayBirthdayPartyCost () ; 

} 


private  void  cakeWriting_TextChanged (object  sender,  EventArgs  e)  ( 
birthdayParty. CakeWriting  =  cakeWriting. Text; 
DisplayBirthdayPartyCost () ; 


I 


IS 


private  void  DisplayBirthdayPartyCost ( )  { 

cakeWriting. Text  =  birthdayParty. CakeWriting; 
decimal  cost  =  birthdayParty. CalculateCost () ; 
birthdayCost.Text  =  cost.ToString("c") ; 

All  -the  intelli^ende  for  dealing  With  waking  sure  the 
writing,  the  number  of  people,  and  the  dake  Size  are  built 
into  the  NumberOf  People  and  CakeWntmg  set  addessors, 
so  the  form  just  has  to  set  and  display  the  values. 


The  way  that  the  form 
handles  the  dake  writing 
dan  be  really  simple  bedause 
the  BirthdayParty  dlass 
is  well  endapsulated  All 
the  form  has  to  do  is  use 
its  dontrols  to  set  the 
properties  on  the  objedt, 
and  the  objedt  takes  dare 
of  the  rest 
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using  System. Windows. Forms; 


public  class  BirthdayParty  { 

public  const  int  CostOfFoodPerPerson  =  25; 


public  decimal  CostOf Decorations  =  0; 
private  bool  fancyDecorations;  s' 

public  int  CakeSize; 


When  -the  BirthdayParty  objedt  is  initialized,  it  needs 
to  know  the  number  o-f  people,  the  -fandy  dedorations 

/and  the  writing  on  the  dake,  so  it  dan  start  out  with 
the  right  dake  dost  when  CaldulateCostO  is  dalled 

public  BirthdayParty (int  numberOf People,  bool  fancyDecorations,  string  cakeWriting)  { 
this.  nuraberOf  People  =  numberOf  People;  Th€  donstrudtor's  dalling  the  set  addessor  to 

this. fancyDecorations  =  fancyDecorations;  ^  take  siting,  in  dase  the  parameter 

is  too  long  -for  the  dake,  so  it’s  got  to 
daldulate  the  dake  size  first 


CalculateCakeSize () ; 
this .CakeWriting  =  cakeWriting; 
CalculateCostOf Decorations (fancyDecorations) ; 


) 


The  donstrudtor  sets 


( 


the  properties  and  then 
runs  the  daldulations. 


private  void  CalculateCakeSize () 
if  (NumberOf People  <=  4) 

CakeSize  =8; 

,  cakeS1"  ‘ 16i 

CaldulateCostO 

private  string  cakeWriting  = 
public  string  CakeWriting  { 

get  {  return  this .cakeWriting; 
set  { 

int  maxLength; 
if  (CakeSize  =  8) 
maxLength  =  16; 

else 

maxLength  =  40; 
if  (value. Length  >  maxLength) 

MessageBox. Show ("Too  many  letters  for  a  "  +  CakeSize  + 
if  (maxLength  >  this. cakeWriting. Length) 
maxLength  =  this. cakeWriting. Length; 
this. cakeWriting  =  cakeWriting. Substring  (0,  maxLength); 


)  ]  The  CakeWriting  property  makes  sure 

/  that  the  dake's  writing  is  never  too  long 
(  fisr  the  dake  size-  Its  set  addessor  dhedks 
r  the  dake  site,  then  uses  the  badking 
\  fields  Length  property  to  make  sure  it's 
\  not  too  long.  |£  «t  is,  it  duts  the  string 
J  down  to  the  right  site 


inch  cake") ; 


> 

else 


this. cakeWriting  =  value; 
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Add  birthday  parties  to  Kathleen's  party  planning  program. 


ExGRCiSG  We're  usin<}  decimal  because  we  re  dealing  w'th 

SoLutioH  V**  a"d  twrm^ 


public  decimal  CalculateCost ( )  { 

decimal  TotalCost  =  CostOfDecorations  + 
decimal  CakeCost; 
if  (CakeSize  ==  8) 

CakeCost  =  40M  +  CakeWriting. Length 

else 

CakeCost  =  75M  +  CakeWriting. Length 
return  TotalCost  +  CakeCost; 

) 


private  int  numberOf People; 
public  int  NumberOf People  { 

get  (  return  numberOf People; 
set  { 

numberOf People  =  value; 


run 


CalculateCostOf Decorations (fancyDecorations) 

CalculateCakeSize ( ) ; 

this. CakeWriting  =  CakeWriting; 


) 


)  This  method  is  just  like  the  one  in 

the  Dinnerparty  class 

public  void  CalculateCostOf Decorations (bool  fancy) 
fancyDecorations  =  fancy; 
if  (fancy) 

CostOfDecorations  =  (NumberOf People  *  15.00M) 

else 

CostOfDecorations  =  (NumberOf People  *  7.50M) 

) 


(CostOfFoodPerPerson  *  NumberOf People) ; 

n.  The  CaltulateCostO  method  is  a 
*  .25M;  I  lot.  like  the  one  -from  DinnerParty, 
'S*-  e*cept  that  it  adds  the  tost  of 
*2  M;  \  the  take  instead  of  the  Healthy 
J  Choice  option 


Makb*  tho  CaWMwj  >aW  ■>»»» 

the  size  of  the  take  is  only  half  of  the 
solution  The  other  half  «  making  sure 
that  the  CakeWriting  set  accessor  yts 
every  time  the  number  of  people  thanys- 

\ 

So  when  the  number  of  people 
thanys,  the  tlass  first 
retaliates  the  take  s.ze,  and 
then  it  uses  its  set  attessor  for 
CakeWriting  to  tut  the  te*t 
down-so  if  a  I  O-person  party 
turns  into  a  ^-person  one,  the.r 
^-letter  messay  will  be  tut 
down  to  one  that'll  f  »t  on  the 
smaller  take 


+  50M; 


+  30M; 


Curly  brackets  are  optional  for  single-line  blocks 

a  w  J  w  h  i-  *  <»  -wr* '  w 

sU-»t  w*  *»  w-k.  W*.  that  ,Ta  that  row*. 

J  ty  bracketa-and  that  ca.  to  « >  «al  ^  ^ 

by  Mbs  y~  tto  U-Oly  Waakbts  ,f  th« .  £  ~  -W* 

7  r  l\  A  <^ta*  for  a  loop  and  an  if  statement 

*"*■*“»  ^  ,  “V ,  if  b*b  =  w 

for  (int  i  -ft  '  <  l0>  ,++) 

-n  .  t.LfiV 


ilue 


inheritance 


One  wore  thing...  can  you  add  a 
MOO  fee  for  parties  over  \P, 

Kathleen’s  gotten  so  much  business  using  your  program  that  site 
can  afford  to  charge  a  little  more  for  some  of  her  larger  clients.  So 
what  would  it  take  to  change  your  program  to  add  in  the  extra 
charge? 

*  Change  the  l)innerParty.CalculateCost()  to  check 
NumberOflVople  and  add  $100  to  the  return  value  if  it's 
over  12. 

*  Do  the  exact  same  thing  for  BirthdayParly.CalculateCostQ. 

Take  a  minute  and  think  about  how  you’d  add  a  fee  to  both  the 
Dinnerparty  and  BirthdayParty  class.  What  code  would  you  write? 
Where  would  it  have  to  go? 

Easy  enough...  but  what  happens  if  there  are  three  similar  classes? 
Or  four?  Or  twelve?  And  what  if  you  had  to  maintain  that  code 
and  make  more  changes  later?  What  if  you  had  to  make  the  same 
exact  change  to  five  or  six  closely  related  classes? 


Wow,  I'd  have  to  write  the  same 
code  over  and  over  again.  That's 
a  really  inefficient  way  to  work. 
There's  got  to  be  a  better  way! 


You’re  right!  Having  the  same  code  repeated  in 
different  classes  is  inefficient  and  error-prone. 

Lucky  for  us,  C#  gives  us  a  better  way  to  build  classes  that  are 
related  to  each  other,  and  share  behavior:  inheritance. 
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no  need  to  use  gold  when  anything  shiny  will  do 


When  your  classes  use  inheritance,  you  only  need 
to  write  your  code  once 


It’s  no  coincidence  that  your  DinnerParty  and  BirthdayParty  classes  have  a  lot  of  the 
same  code.  When  you  write  C#  programs,  you  often  create  classes  that  represent  things 
in  the  real  world  and  those  things  are  usually  related  to  each  other.  Your  classes  have 
similar  code  because  the  things  they  represent  in  the  real  world  a  birthday  party 
and  a  dinner  party  have  similar  behaviors. 


h  birthday  party 
handles  the  number 
people  and  the 
dost  of  dedorations 
•n  almost  the  same 
way  as  a  dinner 
party 


Pinner  parties  and  birthday  parties  are  both  parties 

When  you  have  two  classes  that  are  more  specific  cases  of  something  more 
general,  you  can  set  them  lip  to  inherit  from  the  same  class.  When  you  do 
that,  each  of  them  is  a  subclass  of  the  same  base  class. 


Both  kinds  of  parties 
have  to  keep  tradk  of  the 
number  of  people  and  the 
dost  of  dedorations,  so  you 
dan  move  that  into  the 
base  dlass. 


Party 


This  arrbu/  in 
the  dlass  diagram 
means  the 
Dinnerparty  dlass 
inherits  from  the 

Party  dlass. 


NumberOfPeople 

CostOfDecorattons 


CalculateCostOfDecorationsI) 
CalcUateCostQ 


»  i  —  —  - — n. 

number  of  people  and  daldulating 
the  total  dost  is  similar  but 
distindt  We  dan  break  up  the 
behavior  for  these  things  so  the 
similar  part  is  in  the  base  dlass, 
while  putting  the  distindt  piedes 
in  the  two  subdlasses. 


DinnerPartv 

BirthdavPartv 

NumberOfPeople 

HeatthyOplion 

CostOfBeveragesPerPereon 

Doth  subdlasses 
inherit  the 
dedoration 

NumberOfPeople 

CakeSize 

CakeWriting 

CalculateCostQ 

SetHealthyOption() 

dalculation  from 
the  base  dlass,  so 
■they  don’t  need 
fo  indlude  it. 

CalculateCostQ 
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Puild  up  your  class  model  by  starting  general  and 
getting  more  specific 

C#  programs  use  inheritance  because  it  mimics  the  relationship  that  the  things 
they  model  have  in  the  real  world.  Real-world  things  are  often  in  a  hierarchy 
that  goes  from  more  general  to  more  specific,  and  your  programs  have  their 
own  class  hierarchy  that  does  the  same  thing.  In  your  class  model,  classes 
further  down  in  the  hierarchy  inherit  from  those  above  it. 


General 


Food 


In  a  class  model, 
.Cheese  might  inherit 
•fv'Ol1*  DairyProduCt, 
which  would  inherit 
•from  Food- 


Every  bird  is  an 
animal,  but  not  every 
animal  is  a  bird 


General 


Animal 


Dairy  Product 


Cheese 


Cheddar 


T°  SomeohC  looking  for  a  pet, 
songbird  might  do  But  ’ 
to  an  ornithologist  studying 
the  mimidae  bird  family, 
Confusing  the  Northern 
and  Southern  mock.ngbirds 
*ould  be  unacceptable 


•  Songbird 


Mockingbird 


Aged  Vermont  Cheddar 


Specific  ] 

If  you  have  a  recipe  that  calls 
for  Cheddar  cheese,  then  you 
can  use  aged  l/ermont  Cheddar. 
But  if  it  specifically  needs  aged 
Vermont,  then  you  Can't  just 
use  any  Cheddar— you  need  that 
specific  cheese- 


V_^>  Northern  Mockingbird 

uo- » ti*  1 

«■  all  «f  atbiUte  of  »  Sp’cmc 

above  it  All  animals  eat  and  mate,  so 
Northern  Mockingbirds  eat  and  mate- 

in-her-it,  verb. 

to  derive  an  attribute  From  one’s 
parents  or  ancestors.  She  wanted  the 
baby  to  inherit  her  big  brown  eyes , 
and  not  ho  husband s  beady  blue  ones. 
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it's  a  jungle  out  there 


How  would  you  design  a  zoo  simulator? 

Lions  and  tigers  and  hears...  oh  my!  Also,  hippos,  wolves,  and  the 
occasional  cat.  Your  job  is  to  design  a  program  that  simulates  a  zoo.  (Don't 
get  too  excited — we’re  not  going  to  actually  build  the  code,  just  design  the 
classes  to  represent  the  animals.) 

We’ve  been  given  a  list  of  some  of  the  animals  that  will  be  in  the  program, 
but  not  all  of  them.  We  know  that  each  animal  will  be  represented  by 
an  object,  and  that  the  objects  will  move  around  in  the  simulator,  doing 
whatever  it  is  that  each  particular  animal  is  programmed  to  do. 

More  importantly,  we  want  the  program  to  be  easy  for  other  programmers 
to  maintain,  which  means  they’ll  need  to  be  able  to  add  their  own  classes 
later  on  if  they  want  to  add  new  animals  to  the  simulator. 

So  what’s  the  first  step?  Well,  before  we  can  talk  about  specific  animals, 
we  need  to  figure  out  the  general  things  they  have  in  common, 
abstract  characteristics  that  all  animals  have.  Then  we  can  build  those 
characteristics  into  a  class  that  all  animal  classes  can  inherit  from. 


Look  for  things  the  animals  have  in  common 


lake  a  look  at  these  six  animals.  What  do  a  lion,  a  hippo,  a  tiger, 
a  cat,  a  wolf,  and  a  dalmatian  have  in  common?  How  are  they 
related?  You'll  need  to  figure  out  their  relationships  so  you  can 
come  up  with  a  class  model  that  includes  all  of  them. 
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Use  inheritance  to  avoid  duplicate 
code  in  subclasses 


You’ve  already  got  a  good  idea  that  duplicate  code  sucks.  It's  hard  to 
maintain,  and  always  leads  to  headaches  down  the  road.  So  let’s  choose 
fields  and  methods  for  an  Animal  base  class  that  you  only  have  to  write 
once,  so  each  of  the  animal  subclasses  can  inherit  from  them.  Ixu's  start 
with  the  public  fields: 

*  Picture:  an  image  that  you  can  put  into  a  Picture B< >x. 

*  Food:  the  type  of  food  this  animal  eats.  Right  now,  there  can  be  only 
two  values:  meat  or  grass. 

*  Hunger:  an  int  representing  the  hunger  level  of  the  animal.  It 
changes  depending  on  when  (and  how  much)  the  animal  eats. 


Build  a  base  class  to  give 
the  animals  everything 
they  have  in  common 

The  fields,  properties,  and  methods 
in  the  base  class  will  give  all  of 
the  animals  that  inherit  from  it 
a  common  state  and  behavior. 
They’re  all  animals,  so  it  makes 
sense  to  call  the  base  class  Animal. 


*  Boundaries:  a  reference  to  a  class  that  stores  the  height,  width  and 
location  of  the  pen  that  the  animal  will  roam  around  in. 

*  Location:  the  X  and  Y  coordinates  where  the  animal’s  standing. 
And  the  Animal  class  has  four  methods  the  animals  can  inherit: 

*  MakeNoise  ( ) :  a  method  to  let  the  animal  make  a  sound. 

*  Eat  ( ) :  behavior  for  when  the  animal  encounters  its  preferred  food. 

*  Sleep  ( ) :  a  method  to  make  the  animal  lie  down  and  take  a  nap. 

*  Roam  ( ) :  the  animals  like  to  wander  around  their  pens  in  the  zoo. 


Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoise() 

Eat() 

SleepO 

Roam() 


Choosing  a  base  class  is 
about  making  Choices  You 
Could  have  decided  to 
use  a  XooOtcu^ant  class 
that  defines  the  feed 
and  maintenance  Costs, 
or  an  Attraction  class 
with  methods  for  how 
the  animals  entertain  the 
ZjOO  visitors  But  X  think 
Animal  makes  the  most 
sense  here  Do  you  a^ree? 


Hippo 


Cat 

Dog 

f _ 1 

Pk 
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warning:  don't  feed  the  programmers 


Afferent  animals  make  different  noises 


Lions  roar,  dogs  hark,  and  as  far  as  we  know  hippos  don’t 
make  any  sound  at  all.  Each  of  the  classes  that  inherit  from 
Animal  will  have  a  MakeNoise  ( )  method,  but  each  of  those 
methods  will  work  a  different  way  and  will  have  different  code. 

When  a  subclass  changes  the  beha\ior  of  one  of  the  methods 
that  it  inherited,  we  sav  that  it  overrides  the  method. 

O 

Think  about  what  you  need  to  override 

When  a  subclass  changes  the  behavior  of  a  method  it 
inherited,  we  call  it  overriding.  Every  animal  needs  to 
eat.  But  a  dog  might  take  little  bites  of  meat,  while  a  hippo 
eats  huge  mouthfuls  of  grass.  So  what  would  the  code  for 
that  behavior  look  like?  Both  the  dog  and  the  hippo  would 
override  the  Eat  ( )  method.  The  hippo's  method  would  have 
it  consume,  say,  20  pounds  of  hay  each  time  it  was  called. 

Hie  dog’s  Eat  ( )  method,  on  the  other  hand,  would  reduce 
the  zoo’s  food  supply  by  one  12-ounce  can  of  dog  food. 


Just  because  a  property  or  a  method 
is  in  the  A*'mal  base  that 
doesn’t  mean  every  subclass  has  to  use 

it  the  same  way  or  at  all! 


Figure  out  what  each  animal 
does  that  the  Animal  class  does 
differently— or  not  at  all 

What  does  each  type  of  animal  do  that 
all  the  other  animals  don’t?  Dogs  eat  dog 
food,  so  the  dog’s  Eat()  method  will  need 
to  override  the  Animal .  Eat  ( )  method. 
Hippos  swim,  so  a  hippo  will  have  a 
Swim  ( )  method  that  isn’t  in  the  Animal 
class  at  all. 


,  r 

So  when  you  ve  got  a  subclass 
-that  inherits  -from  a  base 
class,  it  must  inherit  all  o( 
the  base  class’s  behaviors 
but  you  can  modify  them  in 
the  subclass  so  they're  not 
performed  exactly  the  same 
way  That's  what  overriding  IS 
all  about 


Animal 

Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoisef) 

Eat() 

Sleep!) 

Roam() 


We  already  know  that  some  animals  will  override  the 
MakeNoise  ()  and  Eat  ()  methods.  Which  animals  will 
override  Sleep  ( )  or  Roam  ( )  ?  Will  any  of  them?  What  about 
the  properties — which  animals  will  override  some  properties? 
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think  about  how  to  group  the  animals 

Aged  Vermont  cheddar  is  a  kind  of  cheese,  which  is  a  dairy 
product,  which  is  a  kind  of  food,  and  a  good  class  model  for  food 
would  represent  that.  Lucky  for  us,  Cl#  give  us  an  easy  way  to  do 
it.  You  can  create  a  chain  of  classes  that  inherit  from  each  other, 
starting  with  the  topmost  base  class  and  working  down.  So  you 
could  have  a  Food  class,  with  a  subclass  called  Dairy  Product  that 
sen  es  as  the  base  class  for  Cheese,  which  has  a  subclass  called 
Cheddar,  which  is  what  AgedVermontCheddar  inherits  from. 


Look  for  classes  that  have  a  lot 
in  common 


Don’t  dogs  and  wolves  seem  pretty  similar? 
They're  both  canines,  and  it’s  a  good  bet 
that  if  you  look  at  their  behavior  they  have  a 
lot  in  common.  1’hey  probably  eat  the  same 
food  and  sleep  the  same  way.  What  about 
domestic  cats,  tigers,  and  lions?  It  turns  out 
all  three  of  them  move  around  their  habitats 
in  exactly  the  same  way.  It’s  a  good  bet  that 
you'll  be  able  to  have  a  Feline  class  that 
li\  es  between  Animal  and  those  three  cat 
classes  that  can  help  prevent  duplicate  code 
between  them. 


Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoiseO 

Eat() 

Sleep( ) 
Roam() 


MakeNoiseO 

Eat() 


The  subclasses 

inherit  all  &ur 
methods  -from 
Animal,  but 
weVe  only  having 
them  override 
/WakeA/oiseO  and 
EatO.  a 


MakeNoiseO 

EatO 


MakeNoiseO 

EatO 


MakeNoiseO 

EatO 


_ z. 

Tiger 

Hippo 

MakeNoiseO 

MakeNoiseO 

EatO 

Eat() 
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extend  your  objects 


Create  the  class  hierarchy 

When  you  create  your  classes  so  that  there’s  a  base  class  at  the  top  with 
subclasses  below  it,  and  those  subclasses  have  their  own  subclasses  that 
inherit  from  them,  what  you’ve  built  is  called  a  class  hierarchy.  This  is 
about  more  than  just  avoiding  duplicate  code,  although  that  is  certainly 
a  great  benefit  of  a  sensible  hierarchy.  But  when  it  comes  down  to  it,  the 
biggest  benefit  you’ll  get  is  that  your  rode  becomes  really  easy  to  understand 
and  maintain.  W  hen  you’re  looking  at  the  zoo  simulator  code,  when  you  see 
a  method  or  property  defined  in  the  Feline  class,  then  you  immediately  know 
that  you’re  looking  at  something  that  all  of  the  cats  share.  Your  hierarchy 
becomes  a  map  that  helps  you  find  your  way  through  your  program. 

O  Finish  your  class  hierarchy 

Now  that  you  know  how  you'll  organize  the  animal 
you  can  add  the  Feline  and  Canine  classes. 


Animal 


Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoise() 

Eat() 

Sleepf) 

Roam() 


Sinte  Feline  overrides  RodmO, 
anything  that  inherits  £rom  it 
^ets  its  new  RoamO  and  not 
the  one  in  Animal 


Feline 


Roam() 


Ue  Fats  roan,  the 

***  **/>  s°  they  share 
;hKeir,ted  Roam  () 
method  But  each  one 
^11  eats  and  makes  no,se  , 
,,  erentJy,  so  they'll  — 

all  override  Eat  0  and  C 

MakeNoj.se  ()  that 
they  inherited  -from 
Animal. 


Our  wolves  and 
doy  eat  the 
same  way,  so 
>,oved  their 

Common  Eat  (  ) 
method  uf  to 
the  Canine  class 
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Every  subclass  extends  its 
base  class 

You’re  not  limited  to  the  methods  that  a  subclass  inherits 
from  its  base  class...  but  you  already  know  that!  After  all, 
you’ve  been  building  your  own  classes  all  along.  When  you 
add  inheritance  to  a  class,  what  you're  doing  is  taking  the 
class  you’ve  already  built  and  extending  it  by  adding  all  of 
the  fields,  properties,  and  methods  in  the  base  class.  So  if  you 
wanted  to  add  a  Fetch  ( )  method  to  the  dog,  that’s  perfectly 
normal.  It  won’t  inherit  or  override  anything — only  the  dog 
w  ill  have  that  method,  and  it  won’t  end  up  in  Wolf,  Canine, 
Animal,  Hippo,  or  any  other  class. 


hi-er-ar-chy,  noun. 

an  arrangement  or  classification 
in  which  groups  or  things  are 
ranked  one  above  the  other.  The 
president  of  Dynamco  had  worked 
his  way  up  from  the  mailroom  to  the 
top  of  the  corporate  hierarchy. 


Dog  spot  =  new  Dog ( ) ; 
spot .MakeNoise ( ) 
spot .Roam ( ) ; 
spot  .Eat  ()  ; 
spot  .Sleep  ()  ; 
spot . Fetch ( ) ; 


makes  a  new  D05  object 

Calls  the  version  in 


Calls  the  version  in  Animal 


Calls  the  version  in  Canine 


Calls  the  version  in  Canine 


Calls  the  version  in  D 


C#  always  calls  the  most  specific  method 

If  you  tell  your  dog  object  to  roam,  there's  only  one  method  that  can 
be  called  the  one  in  the  Animal  class.  Hut  what  about  telling  your 
dog  to  make  noise?  Which  MakeNoise  ( )  is  called? 

Well,  it's  not  too  hard  to  figure  it  out.  A  method  in  the  Dog  class  tells 
you  how  dogs  do  dial  thing.  If  it's  in  the  Canine  class,  it's  telling  you 
how  all  canines  do  it.  And  if  it’s  in  Animal,  then  it’s  a  description  of 
that  behavior  that’s  so  general  that  it  applies  to  every  single  animal.  So 
if  you  ask  your  dog  to  make  a  noise,  first  Cl#  will  look  inside  the  dog 
class  to  find  the  behavior  that  applies  specifically  to  dogs.  If  Dog  didn’t 
have  one,  it’d  then  check  Canine,  and  after  dial  it’d  check  Animal. 


Animal 


Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoiseQ 

Eat() 

Sleep() 

Roam() 
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base  how  low  can  you  go? 


Use  a  colon  to  inherit  from  a  base  class 

When  you're  writing  a  class,  you  use  a  colon  (:)  to  have  it  inherit  from 
a  base  class.  That  makes  it  a  subclass,  and  gives  it  all  of  the  Helds, 
properties,  and  methods  of  the  class  it  inherits  from. 


Animal 


NumberOfLegs 


Eat() 


public  class  Animal 

{ 

public  int  NumberOfLegs; 
public  void  Eat()  { 

//  code  to  make  the  animal  eat 

} 

id»TW  — O-U**^** 

public  class  Bird 

{ 


Wken  a  sukclass 
inkerits  from  a 
kase  class,  all 
of  tke  fields, 
properties,  and 
metkods  in  tke 
kase  class  are 
automatically 
added  to  tke 
sukclass. 


public  double  Wingspan; 
public  void  Fly()  { 

//  code  to  make  the  bird 

} 


} 


You  extend  a  class 
by  adding  a  Colon  -to 
the  end  of  the  class 
declaration,  -followed  by 
the  base  class  to  inherit 
■from. 


tv/eety  is  an  instance 
o-f  Bird,  So  it's  got 
the  Bird  methods  — 
and  fields  as  usual. 


there  yve  nQ 

Dumb  Questions 


public  buttonl_Click (object  sender,  EventArgs  e)  { 
Bird  tweety  =  new  Bird(); 

{tweety. Wingspan  =  7.5; 
tweety . Fly ( ) ; 
tweety .NumberOfLegs  =  2; 
tweety. Eat () ; 


} 


Since  the  Bird  class  inherits 
from  Animal,  every 

of  Bird  also  has  the  f  ields 

and  methods  def  ined  •*  the 
Animal  class. 


0 


r,-  Why  does  the  arrow  point  up,  from  the  subclass  to  the 
base  class?  Wouldn't  the  diagram  look  better  with  the  arrow 
pointing  down  instead? 

j\’.  It  might  look  better,  but  it  wouldn  t  be  as  accurate.  When  you 
set  up  a  class  to  inherit  from  another  one,  you  build  that  relationship 
into  the  subclass— the  base  class  remains  the  same.  And  that  makes 
sense  when  you  think  about  it  from  the  perspective  of  the  base  class 


Its  behavior  is  completely  unchanged  when  you  add  a  class  that 
inherits  from  it.  The  base  class  isn't  even  aware  of  this  new  class 
that  inherited  from  it.  Its  methods,  fields,  and  properties  remain 
entirely  intact.  But  the  subclass  definitely  changes  its  behavior.  Every 
instance  of  the  subclass  automatically  gets  all  of  the  properties,  fields, 
and  methods  from  the  base  class,  and  it  all  happens  just  by  adding  a 
colon.  That’s  why  you  draw  the  arrow  on  your  diagram  so  that  it's  part 
of  the  subclass,  and  points  to  the  base  class  that  it  inherits  from 
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Take  a  look  at  these  class  models  and  declarations,  and  then 
circle  the  statements  that  won't  work. 


Aircraft  k 

AirSpeed 

Altitude 


TakeOff() 

Land() 


FirePlane 

BucketCapacity 

FillBucketO 

public  class  Aircraft  { 
public  double  AirSpeed; 
public  double  Altitude; 
public  void  TakeOff 0  {  ...  }; 
public  void  Land()  {  ...  }; 

} 

public  class  FirePlane  :  Aircraft  { 
public  double  BucketCapacity; 
public  void  FillBucketO  {  ...  (; 

} 

public  void  FireFightingMission ( )  { 

FirePlane  myFirePlane  =  new  FirePlane (); 
new  FirePlane. BucketCapacity  =  500; 
Aircraft .Altitude  =  0; 
myFirePlane. TakeOff () ; 
myFirePlane .AirSpeed  =  192.5; 
myFirePlane . FillBucket ( ) ; 

Aircraft . Land ( ) ; 

} 


Sandwich 

Toasted 

SlicesOfBread 


CountCaloriesO 


SlicesOfBacon 


AmountOflettuce 


AddSideOfFnesQ 


public  class  Sandwich  { 
public  boolean  Toasted; 
public  int  SlicesOfBread; 
public  int  CountCaloriesO  {  ...  } 

} 


public  class  BLT  :  Sandwich  { 
public  int  SlicesOfBacon; 
public  int  AmountOfLettuce; 
public  int  AddSideOf Fries ( )  {  ...  } 


public  BLT  OrderMyBLT ( )  ( 

BLT  mySandwich  =  new  BLT 0 ; 

BLT. Toasted  =  true; 

Sandwich. SlicesOfBread  =  3; 
mySandwich .AddSideOf Fries ( ) ; 
mySandwich. SlicesOfBacon  +=  5; 
MessageBox.Show("My  sandwich  has  " 

+  mySandwich. CountCalories  +  "calories".); 
return  mySandwich; 


you  are  here  ► 
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/  can  think  of  one  way  to  make  a  penguin  fly... 


Sharpen  your  pencil 
^  v  Solution 


Take  a  look  at  these  class  models  and  declarations,  and  then 
circle  the  statements  that  won't  work. 


Aircraft 

AirSpeed 

Altitude 


TakeOff() 

Land() 


FirePlane 

BucketCapacity 


I  FillBucket() 


public  class  Aircraft  { 
public  double  AirSpeed; 
public  double  Altitude; 
public  void  TakeOff ()  {  ... 
public  void  Land()  {  ...  }; 


public  class  FirePlane  :  Aircraft  ( 
public  double  BucketCapacity; 
public  void  FillBucket()  {  ...  }; 

}  JW*  not  how  you  use 

public  void  FireFightingMission  ( )  {  the  new 

FirePlane  mvFi-rpPlane  =  new  FirePlane  ( )  ;/ 

<oew  FirePlane . BucketCapacity  =  l.ii.Hr;  -y— ^ 
CJxldratt.AitrLude  =-rrryf^_  ,  L*aUusetbe 

myFirePlane. Takeoft  ()  ;  '  '"''■x  These  statement  -  , 

myFirePlane .AirSpeed  =  192.5;  '  >  irvstedd  <A  t  e 

myFirePlane . FillBucket () ;  ,nstante,  myf'tvePlant 


Sandwich 

Toasted 

SlicesOfBread 


CountCalones() 


public  class  Sandwich  { 
public  boolean  Toasted; 
public  int  SlicesOfBread; 
public  int  CountCalories ( )  { 


public  class  BLT  :  Sandwich  { 
public  int  SlicesOfBacon; 
public  int  AmountOf Lettuce; 
public  int  AddSideOf Fries ()  { 


These  yvoyerl.es  ave  yavt  ^  t  e 
,*sta nte,  but  the  statements  are 
trying  to  tall  t hem  mdovvettl 7 
}  us.n^  the  tlass  names 


BLT 

SlicesOfBacon 

AmountOflettuce 


AddSideOfFnesQ 


public  BLT  OrderMyBLTO  {  / 

R1iT,  r-h  --  new  BLT  ( )  ;  /  CountCa/ovies 

/BLT. Toasted  =  true;  this  states 

VSandwich.  SlicesOfBread  =  3;^^ 
mySandwich. AaabiaeOTF  I  le.9  J  e  P^enthes* 

mySandwich.  SlicesOfBacon  +=  5; _ tsllio  ike  r»c- 

/MessaigeBox .  Show  ('~'My  sandwich  has  "  ■ — - — _ 

x.  +  mySandwich .CountCalories  +  "calories".); 


J  -akoj,  but 

a  0  ****  ik< 

ft*  vtu  \ 
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We  know  that  inheritance  adds  the  base  class  fields, 
properties,  and  methods  to  the  subclass... 


Inheritance  is  simple  when  your  subclass 
needs  to  inherit  all  of  the  base  class 


methods,  properties,  and  Helds. 


Pigeon  is  a 
subclass  of  Bird, 
so  any  fields  and 
methods  in  Bird 
are  automatically 
yart  of  Pigeon, 


too 


Bird 

FlyO 

LayEggsf) 

PreenFeathersf) 

Pigeon 

CooO 


public  class  Bird  { 
public  void  FlyO  { 

//  here's  the  code  to  make  the  bird  fly 

) 

public  void  LayEggs 0  i  ...  }; 
public  void  PreenFeathers ()  {  ...  }; 


public  class  Pigeon  :  Bird  { 
public  void  Coo ( )  {  ...  } 

1 


l _ I  public  class  Penguin  :  Bird  { 

public  void  SwimO  {  ...  } 

but  some  birds  don't  fly!  > 


W  hat  do  you  do  if  your  base  class  has  a 
method  that  your  subclass  needs  to  modify ? 

,zf/ ,s  an  '*stan£e 
**  P«"3uin  Si nde  Ft 


public  void  BirdSimulator ()  ( 

Pigeon  Harriet  =  new  Pigeon (); 
Penguin  Izzy  =  new  Penguin (); 
inherited  the  RyO  Harriet. Fly () 


method,  there's  nothing  \  Harriet .  Coo  ( ) 
stopping  it  Pro m  -flying.  lZZy. FlyO  ; 


Both  Pigeon  and  Penguin 
inherit  from  Bird,  so 
they  both  get  the 
RyO,  LayBgyO,  and 

PreenPeathersO  methods 


(W*  %  ft  'w' 

"  -their  feathers,  SO 

r**"*,  .  W  With  the 

there's  no  Y*****  r 
Pigeon  Class  inherit^ 

Bird 


Penguin  objects  shouldn't  be  able  to  fly/ 

Peh!H  inherits  Prom  Bird, 
.  then  you  II  have  penguins  Plying  a|,  ove,  ^ 

place.  So  what  do  we  do? 


If  this  were  your  Bird  Simulator  code,  what  would 
you  do  to  keep  the  penguins  from  flying? 


you  are  here  ► 
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manual  override 


A  subclass  can  override  methods  to  change  or 
replace  methods  it  inherited 

Sometimes  you’ve  got  a  subclass  that  you’d  like  to  inherit 
most  of  the  behaviors  from  the  base  class,  but  not  all  of  them. 

W  hen  you  want  to  change  (lie  behaviors  that  a  class  has 
inherited,  you  can  override  the  methods. 


Add  the  virtual  keyword  to  the  method  in  the  base  class 

A  subclass  can  only  override  a  method  if  it  s  marked  with  the  virtual  keyword,  which 
tells  C#  to  allow  the  subclass  to  override  methods. 


public  class  Bird  { 

public  virtual  void  Fly()  { 

//  code  to  make  the  bird  fly 


(Adding  -the  virtual 

keyword  bo  the  FI/) 

"'eihod  bells  C#  that 
a  subclass  is  allowed  to 


override  it- 


} 


Add  a  method  with  the  same  name  to  the  derived  class 

You'll  need  to  bas  e  exactly  the  same  signature  meaning  the  same  return  value  and 
parameters  and  you'll  need  to  use  the  override  keyword  in  the  declaration. 


public  class  Penguin  :  Bird  { 

kf 

public  override  void  Fly ( )  { 

MessageBox . Show ("Penguins  can't  fly!") 


*77*  >  -riM,  aid 

I  -rikod  io  thC 
the  override  keyword- 


} 


When  you  override  a  method,  your  new 
method  needs  to  have  enattly  the  same 
signature  as  the  method  in  the  base 
class  it's  overriding  In  this  case,  that 
means  it  needs  to  be  called  Fly,  'return 
void,  and  have  no  parameters 


Use  the  override  keyword  to 
add  a  method  to  jour  subclass 
tkat  replaces  one  tkat  it 
inkerited.  Before  jou  can 
override  a  metkod,  jou  need  to 
mark  it  virtual  in  tke  kase  class. 


226  Chapter  6 


inheritance 


Any  place  where  you  can  use  a  base  class,  you  can 
use  one  of  its  subclasses  instead 

One  of  the  most  useful  tilings  you  can  do  with  inheritance  is  use  a  subclass  in 
place  of  the  base  class  it  inherits  from.  So  if  your  Recipe  ( )  method  takes  a 
Cheese  object  and  you've  got  an  AgedVermontCheddar  class  that  inherits 
from  Cheese,  then  you  can  pass  an  instance  of  AgedVermontCheddar  to 
the  Recipe  ( )  method.  Recipe  ( )  only  has  access  to  the  fields,  properties, 
and  methods  that  are  part  of  die  Cheese  class,  though  it  doesn’t  have  access 
to  anything  specific  to  AgedVermontCheddar. 


Sandwich 

Toasted 

SlicesOfBread 


CountCalonesQ 


_ 

BLT 

SlicesOfBacon 

AmountOLettuce 


let’s  say  we  have  a  method  to  analyze  sandwich  objects: 


public  void  SandwichAnalyzer (Sandwich  specimen) 
int  calories  =  specimen. CountCalories () ; 
UpdateDietPlan (calories) ; 


AddSideOfFnest) 


Perf ormBreadCalculations (specimen . SlicesOfBread,  specimen . Toasted) ; 


} 


You  could  pass  a  sandwich  to  die  method  but  you  could  also  pass  a  BLT.  Since  a  BLT  is  a 
kind  of  sandwich,  we  set  it  up  so  that  it  inherits  from  the  Sandwich  class. 


public  buttonl  Click (object  sender,  EventArgs  e) 
BLT  myBLT  =  new  BLT ( ) ; 

SandwichAnalyzer (myBLT) ; 

} 


{ 


We’ll  talk  about  this  move 
in  the  ne*t  thafW 


You  can  always  move  down  the  class  diagram — a  reference  variable  can  always  be  set  equal 
to  an  instance  of  one  of  its  subclasses.  But  you  can’t  move  up  the  class  diagram. 


public  button2_Click (object  sender,  EventArgs  e)  { 

Sandwich  mySandwich  =  new  Sandwich  () ;  You  tan  assign  my&LX  -to  any 

BLT  myBLT  =  new  BLT  ( )  ;  y - Sandwith  variable  betause  a 

Sandwich  someRandomSandwich  =  myBLT;  is  a  kind  o£  sandwidh. 

BLT  anotherBLT  =  mySandwich;  //  <-—  THIS  WON'T  COMPILE! ! ! 


} 


v.„,,r  ~fi***k  to  a  BLT 

That',  '  k  “it'*,  "t  Wty  sihdwl>  “  3  8LTI 


you  are  here  > 
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get  a  little  practice 


MiX'd  * :  ‘ 

MesSagcs  *  - 5 

Instructions: 

1.  Fill  in  the  four  blanks  in  the  code. 

2.  Match  the  code  candidates  to  the  output. 


DC 

11 

65 


A  short  C#  program  is  listed  below.One  block  of 
the  program  is  missing!  Your  challenge  is  to  match 
the  candidate  block  of  code  (on  the  left),  with 
the  output — what's  in  the  messagebox  that  the 
program  pops  up — that  you’d  see  if  the  block  were 
inserted.  Not  all  the  lines  of  output  will  be  used,  and 
some  of  the  lines  of  output  might  be  used  more 
than  once.  Draw  lines  connecting  the  candidate 
blocks  of  code  with  their  matching  output. 


public  class  A  { 

public  int  ivar  =7; 

public  _  string  ml()  { 

return  "A's  ml, 

) 

public  string  m2()  { 
return  "A' s  m2, 

) 

public  _  string  m3()  { 

return  "A's  m3, 

) 

} 

public  class  B  :  A  { 

public  _  string  ml()  { 

return  ”B's  ml, 

) 

} 


code 

candidates: 


q 

q 

q 

q 

q 

q 

q 

q 

q 

q 

q 

q 


+= 

+= 

+= 

+= 

+= 

+= 

+= 

+= 

+= 


+= 


+= 


+= 


b .  ml  ( ) ;  ■» 

c .  m2 ( ) ;  > 
a . m3 ( ) ;  ^ 


c .ml  () ;  "I 
c.m2  ();  r 
c .  m3  ( ) ; 


a.  ml  () ;  'I 

b . m2  () ;  f 

c .  m3 ( ) ; 


a2  .ml  ()  ;  T 
a2  .m2  () ;  j 
a2 .m3 ( ) ; 


public  class  C 
public  _ 


B  ( 


return  "C's  m3, 


string  m3 ()  { 

'  +  (ivar  +  6); 


) 


,  ^Ke  e"^y  point  £or  the  pv-ogv-am-it 

does*  t  show  a  torn,,  it  just  pops  up  a  messagebox. 

public  class  Mixed5  (  X 

public  static  void  Mam (string [ ]  args)  { 

A  a  =  new  A ( ) ; 

B  b  =  new  B ( ) 


C  c  =  new  C ( ) 

A  a2  =  new  C  () ; 
string  q  = 


candidate  code 
goes  here 

(three  lines) 


System. Windows . Forms .MessageBox . Show (q) ; 


output: 


A's 

ml, 

A's 

m2. 

C's 

m3. 

6 

B's 

ml , 

A's 

m2. 

A's 

m3, 

A's 

ml , 

B's 

m2. 

A's 

m3. 

B's 

ml, 

A's 

m2. 

C's 

m3. 

13 

B's 

ml, 

C's 

m2. 

A's 

m3. 

B's 

ml , 

A's 

m2. 

C's 

m3. 

6 

A' s 

ml, 

A' s 

m2, 

C's 

m3. 

13 

(Don’t  just  type  this  into  the  IDE — you’ll  learn 
a  lot  more  if  you  figure  this  out  on  paper!) 
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Rowboat  subclasses 

■r  Sailboat 

Boat  Testboats 

int  len 

return  virtual 

continue  int  length 

break  .  mt  bl 

'  int  b2  intb3  . 

b3  ^  length  jnt  b2  ,n 


override 

drift  hoi 
stroke  natasha 
string 

void  ... 

public 

private 


rowTheBoat 


move 


setLength 


static 


getLength 


Poo]  puzzje 

Your  job  is  to  take  code  snippets  from  the  pool  and  place  them  into 
the  blank  lines  in  the  code.  You  may  use  the  same  snippet  more 
than  once,  and  you  might  not  need  to  use  all  the  snippets. Your 
goal  is  to  make  a  set  of  classes  that  will  compile  and  run  together 
as  a  program.  Don't  be  fooled — this  one's  harder  than  it  looks. 


public  class  Rowboat  { 

public  rowTheBoat ( )  { 

return  "stroke  natasha"; 

) 

) 


public  class . ( 

private  int  ; 

void  ( 


length  =  len; 

) 

public  int  getLength ()  { 


) 

public  move(>  { 

return  ” .  "; 

) 


public  class  TestBoats  { 

. MalnO  |  < - -v  ■  tk« 

.  .  xyi  - 

. * .  the  progvarw. 

bl  =  new  Boat ( ) ; 

Sailboat  b2  -  new  .  (); 

Rowboat  =  new  Rowboat ( ) ; 

b2 .setLength (32) ; 
xyz  -  bl .  ()  ; 

xyz  +=  b3.  . .  ()  ; 

xyz  +-  .move!); 

System. Windows. Forms .MessageBox. Show (xyz) ; 

} 

} 


public  class 
public 
return 


OUTPUT: 


drift  drift  hoist  sail 
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not  all  penguins  are  birds 


a  =  6; 
b  =  5; 
a  =  5; 


MiX<d 

Messages 

ExGRCiSG  public  class  A  ( 

SoUitlOH  public  virtual _ string  ml()  { 


56 

11 

65 


public  class  B  :  A  { 

public  override  string  ml()  ( 


public 


virtual 


string  m3()  {  public  class  C  :  B  { 


Pool  Puz/Je  Solution 


public  class  Rowboat  . Boat. . ( 

public.  stV''l....rowTheBoat<)  1 
return  "stroke  natasha"; 

} 

} 

public  class  Boat  ( 
private  int  ; 

^ublit  .  void ..setLerjgtb . ( ..jut.!??... 1 

length  =  len; 


) 


public  int  getLengthf)  ( 

return  JehjtK _ ; 

) 

public  ....  virtual  moved  | 

return  ...d*ft . ”> 

) 


) 


public  class  TestBoats  { 

rfe.statit  Vcndtein  ()  ( 

.. Sprit'S-..  xvz  = 

Boat  bl  -  new  Boat  ( ) ; 

Sailboat  b2  =  new  Sailboat  (); 

Rowboat  \A  -  new  Rowboat  ( ) ; 

b2.setLength (32) ; 

xyz  =  bl .  move  ( )  ; 

xyz  t-  b3.  ..JfW?.,,  0  « 

xyz  +=  b2-  . move ( ) ; 

System . Windows . Forms .MessageBox . Show (xyz) 


} 

) 

public  class  Sailboat  :  Boat  ( 
public  override  string  move  o  ( 
return  ”  boist  sail  *; 

} 

> 
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Qj  About  the  entry  point  that  you 
pointed  out  in  the  Pool  Puzzle— does  this 
mean  I  can  have  a  program  that  doesn't 
have  a  Forml  form? 

Yes  When  you  create  a  new  Windows 
Application  project,  the  IDE  creates  all 
the  files  for  that  project  for  you,  including 
Program.es  (which  contains  a  static  class 
with  an  entry  point)  and  Forml.cs  (which 
contains  an  empty  form  called  Forml). 

Try  this:  instead  of  creating  a  new  Windows 
Application  project,  create  an  empty  project 
by  selecting  “Empty  Project"  instead  of 
“Windows  Application”  when  you  create  a 
new  project  in  the  IDE.  Then  add  a  class 
file  to  it  in  the  Solution  Explorer  and  type  in 
everything  in  the  Pool  Puzzle  solution  Since 
your  program  uses  a  messagebox,  you 
need  to  add  a  reference  by  right-clicking 
on  “References"  in  the  Solution  Explorer, 
selecting  "Add  Reference",  and  choosing 
System. Windows, Forms  from  the  NET  tab. 
(That's  another  thing  the  IDE  does  for  you 
automatically  when  you  create  a  Windows 
Application.)  Finally,  select  “Properties’  from 
the  Project  menu  and  choose  the  “Windows 
Application’  project  type. 

Now  run  it...  you’ll  see  the  results! 
Congratulations,  you  just  created  a  C# 
program  from  scratch. 


I 

Flip  back  to  the 
of  Chapter  2.  if  you  need  a 
refresher  on  MainO  and  the 
,try  point! 


en 


there  |  ore  no 

Dumb  Questions 

o 

V,'  Can  I  inherit  from  the  class  that 
contains  the  entry  point? 

Yes.  The  entry  point  must  be  a  static 
method,  but  that  method  doesn’t  have 
to  be  in  a  static  class.  (Remember,  the 
static  keyword  means  that  the  class 
can’t  be  instantiated,  but  that  its  methods 
are  available  as  soon  as  the  program  starts. 
So  in  the  Pool  Puzzle  program,  you  can  call 
TestBoats.Main()  from  any  other  method 
without  declanng  a  reference  variable 
or  instantiating  an  object  using  a  new 
statement) 

o 

I  still  don't  get  why  they’re  called 
“virtual"  methods— they  seem  real  to  me! 

j\'.  The  name  “virtual"  has  to  do  with  how 
NET  handles  the  virtual  methods  behind  the 
scenes.  It  uses  something  called  a  virtual 
method  table  (or  vtable).  That’s  a  table  that 
NET  uses  to  keep  track  of  which  methods 
are  inherited  and  which  ones  have  been 
overridden  Don't  worry— you  don’t  need  to 
know  how  it  works  to  use  virtual  methods! 

O  ”  What  did  you  mean  by  only  being 
able  to  move  up  the  class  diagram  but 
not  being  able  to  move  down? 


When  you’ve  got  a  diagram  with  one 
class  that's  above  another  one,  the  class 
that’s  higher  up  is  more  abstract  than  the 
one  that's  lower  down.  More  specific  or 
concrete  classes  (like  Shirt  or  Car)  inherit 
from  more  abstract  ones  (like  Clothing  or 
Vehicle).  When  you  think  about  it  that  way, 
it's  easy  to  see  how  if  all  you  need  is  any 
vehicle,  a  car  or  van  or  motorcycle  will  do. 
But  if  you  need  a  car,  a  motorcycle  won't  be 
useful  to  you. 

Inheritance  works  exactly  the  same  way  If 
you  have  a  method  with  Vehicle  as  a 
parameter,  and  if  the  Motorcycle  class 
inherits  from  the  Vehicle  class,  then  you 
can  pass  an  instance  of  Motorcycle 
to  the  method.  But  if  the  method  takes 
Motorcycle  as  a  parameter,  you  can't 
pass  any  Vehicle  object,  because  it  may 
be  a  Van  instance.  Otherwise  C#  wouldn’t 
know  what  to  do  when  the  method  tries  to 
access  the  Handlebars  property! 


Y  ou  can  always 
pass  an  instance 
o{  a  subclass  to 
any  method  whose 
parameters  expect 
a  class  that  it 
inherits  Irom. 


you  are  here  ► 


231 


detour:  construction  ahead 


A  subclass  can  access  its  base  class  using  the  base  keyword 


Even  when  you  override  a  method  or  property  in  your  base  class, 
sometimes  you’ll  still  want  to  access  it.  Luckily,  we  can  use  base,  which 
lets  us  access  any  method  in  the  base  class. 


Animal 


NumberOflegs 


All  animals  eat,  so  the  Animal  class  has  an  Eat  ( )  method  that  takes  a 
Food  object  as  its  parameter. 

public  class  Animal  { 

public  virtual  void  Eat (Food  morsel)  { 

Swallow  (morsel) ; 

Digest  (); 


Eat() 

Swallow) ) 
Digestf) 


Chameleon 

TongueLength 

Color 


CatchWrthTor>gue() 


Chameleons  eat  by  catching  food  with  their  tongues.  So  the  Chameleon  class  inherits 
from  Animal  but  overrides  Eat  ( ) . 

public  class  Chameleon  :  Animal  ( 

public  override  void  Eat (Food  morsel)  ( 

CatchWithTongue (morsel) ; 

Swallow  (morsel)  The  chameleon  heeds  to  swallow  and  d.< 

Digest  ( )  ;  _ f  ‘  ^he -Pood,  just  like  any  other  animal.  t>, 

)  really  need  to  duplicate  this  code,  thoi 


Instead  of  duplicating  the  code,  we  can  use  the  base  keyword  to  call  the  method  that 
was  overridden.  Now  we  have  access  to  both  the  old  and  the  new  version  of  Eat  ( ) . 

public  class  Chameleon  :  Animal  { 

public  override  void  Eat (Food  morsel)  { 

CatchWithTongue (morsel) ; 

base .Eat (morsel) ; 


inherited 
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When  a  base  class  has  a  constructor  your  subclass  needs  one  too 


If  your  class  has  a  constructor,  then  any  class  that  inherits  from 
it  must  call  that  constructor.  The  subclass’s  constructor  can 
have  different  parameters  from  the  base  class  constructor. 


y°^  subclass  ~ 

to  iell  C#  that 


ion 


Here's  -the 
Constructor  £<*- 
tKe  subclass. 


public  class  Subclass  :  BaseClass  { 

— ^public  Subclass (parameter  list) 

:  base (the  base  class's  parameter  list)  { 


*bclass  is  instantiated  X*7  ^  ihe 


} 


//  first  the  base  class  constructor  is  executed 
//  then  any  statements  here  get  executed 


} 


The  base  class  constructor  Is  executed 
before  the  subclass  constructor 

But  don’t  take  our  word  for  it — sec  for  yourself! 


* 

p  tills! 

J  ♦ 


Create  a  base  class  with  a  constructor  that  pops  up  a  messagebox 

Then  add  a  button  to  a  form  that  instantiates  this  base  class  and  shows  a  messagebox: 

public  class  MyBaseClass  { 

public  MyBaseClass (string  baseClassNeedsThis)  { 

MessageBox. Show ("This  is  the  base  class:  "  +  baseClassNeedsThis); 


) 


) 


This  is  a  parameter  that  the 
base  class  Constructor  needs. 


)  Try  adding  a  subclass,  but  don't  call  the  constructor 

Then  add  a  button  to  a  form  that  instantiates  this  subclass  and  shows  a  messageljox: 

public  class  MySubclass  :  MyBaseClass ( 

(  public  MySubclass (string  baseClassNeedsThis,  int  anotherValue)  { 


Select  Build  »  Build 
Solution  in  tbe  ID B 
and  you'll  get  an  ) 
err°r  trom  this )  Code 


MessageBox. Show ("This  is  the  subclass: 
+  "  and  "  +  anotherValue) ; 


+  baseClassNeedsThis 


^Noovertoac^bMnetho^MyBaseClass^ake^O^r^jrnent^k 


Keep  an  eye 
out  -for  this 
slightly  Cryptic 
error,  ft  means 
that  your 
subclass  didn't 
inherit  the 
Constructor 
properly. 


Fix  the  error  by  making  the  constructor  call  the  one  from  the  base  class 

Then  instantiate  the  subclass  and  see  what  order  the  two  message  boxes  pop  up! 
public  class  MySubclass  :  MyBaseClass ( 

This  is  how  public  MySubclass  (string  baseClassNeedsThis,  int  anotherValue)  constructor  in 

we  send  the _ :  base  (baseClassNeedsThis)  A aj  this  line  to  'tell  to  e  ,  T,  .  , 

tb»  d»  it  >>*  a  ff it *£ Z  Tk» 

parameter  its  //  the  rest  of  the  subclass  is  the  same  uihat  <\ets  passed  to  the  base  C ass  on  to 

Constructor  the  error  will  go  away  and  you  tan  ma  e  a 

needs 


ol 


see  the  two  message  Wes  pop  up 
you  are  here  ► 
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kathleen  still  needs  our  help 


Now  you're  ready  to  finish  the  job  for  Kathleen! 


W  hen  you  last  left  Kathleen,  you’d  finished  adding 
birthday  parties  to  her  program.  She  needs  you  to 
charge  an  extra  SI 00  for  parties  over  12.  It  seemed 
like  you  were  going  to  have  to  write  the  same  exact 
code  twice,  once  for  each  class.  Now  that  you  know 
how  to  use  inheritance,  you  can  have  them  inherit 
from  the  same  base  class  that  contains  all  of  their 
shared  code,  so  you  only  have  to  w  rite  it  once. 


ff'i 


DinnerParty 

BirthdayParty 

NumberOfPeople 

NumberOfPeople 

CostOfDecorations 

CostOfDecorations 

CostOfBeveragesPerPerson 

CakeSize 

HealthyOption 

CakeWnting 

CalculateCostOfDecorations() 

CalculateCostOfDecorationsQ 

CalculateCost() 

CalculateCost() 

SetHealthyOption() 

E*e*ctSe 


If  we  play  our  cards 
two  classes  without 


right,  we  should  be  able  to  change  the 
making  any  changes  to  the  form! 


Let's  create  the  new  class  model 

We  ll  still  have  the  same  Dinnerparty  and  BirthdayParty  classes,  but  now  they'll  inherit  from  a 
single  Party  class.  We  need  them  to  have  exactly  the  same  methods,  properties  and  fields,  so  we 
don’t  have  to  make  any  changes  to  the  form.  But  some  of  those  methods,  properties,  and  fields 
will  be  moved  into  the  Party  base  class,  and  we  may  have  to  override  a  few  of  them. 
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Build  the  Party  base  class 

Create  the  Party  class  make  sure  it’s  public  .  You’ll  need  to  look  really  closely  at  the 
properties  and  methods  in  the  class  diagram,  and  figure  out  what  you  need  to  move  out  of 
DinnerParty  and  BirthdavParty  and  into  Party. 


*  Move  the  NumberOfPeoplc  and  CostOfDecorations  properties  into  it  so  that  they’re 
compatible  with  both  DinnerParty  and  BirthdayParty. 

*  Do  the  same  lor  the  CalculateCost()fDecorations0  and  CalculateCostQ  methods.  If 
those  methods  need  any  private  fields,  you'll  need  to  move  them  too.  (Remember, 
subclasses  only  inherit  public  fields — once  you  move  a  private  field  to  Party,  the 
DinnerParty  and  BirthdayParty  classes  won’t  have  access  to  it.) 

*  You’ll  also  need  a  constructor.  Take  a  close  look  at  the  BirthdayParty  and 
DinnerParty  constructors  anything  they  have  in  common  should  lie  moved  to  it. 

*  Now  add  the  $100  bonus  for  parties  over  12  people.  .After  all,  that’s  why  we’re 
doing  this!  It’s  common  to  both  birthday  and  dinner  parties,  so  it  belongs  in  Party. 


Make  DinnerParty  inherit  from  Party 

Now  that  Party  does  a  lot  of  the  things  DinnerParty  does,  you  can  eliminate  the  overlap  and 
only  keep  the  part  of  DinnerParty  that's  unique  to  dinner  parties. 

*  Make  sure  the  constructor  is  working  properly.  Does  it  do  anything  the  Party 
constructor  doesn’t?  If  so,  keep  that  and  then  leave  everything  else  to  the  base  class 
constructor. 

*  Any  logic  that  has  to  do  with  setting  the  healthy  option  should  stay  in  DinnerParty. 

*  You'll  need  to  override  at  least  one  method  because  it  does  something  specific  to 
dinner  parties. 


Make  BirthdayParty  inherit  from  Party 

Do  the  same  thing  for  BirthdayParty — leave  anything  not  specific  to  birthdays  to  the  base 
class,  and  only  keep  the  birthday-specific  functionality  in  BirthdayParty 

*  What  does  the  BirthdayParty  constructor  need  to  do  dial’s  not  part  of  Party? 

*  You’ll  need  to  deal  with  the  cost  of  the  cake  inside  of  BirthdayParty.  That  touches  a 
method  and  a  property,  so  you'll  need  to  override  them. 

*  Yes,  you  can  override  a  property!  It’s  just  like  overriding  a  method.  When  you  set  the 
value  of  base  .NumberOf  People,  it  calls  the  property’s  set  accessor  in  the  base 
class.  You'll  need  to  use  the  base  keyword  to  both  get  and  set  the  value. 


you  are  here  > 


235 


exercise  solution 


ExeRciSe 

So(.ytlOH 


Check  it  out— you  changed  the  DinnerParty  and  BirthdayParty 
classes  so  that  they  inherited  from  the  same  base  class. 

Party.  Then  you  were  able  to  make  the  change  to  the  cost 
calculation  to  add  the  $100  fee,  and  you  didn't  have  to 
change  the  form  at  all  Neat! 


public  class  Party 

{ 

const  int  CostOf FoodPerPerson  =  25; 
private  bool  fancyDecorations; 
public  decimal  CostOfDecorations  =  0; 


This  Code  was  moved  straight  out  of 
the  DinnerParty  and  BirthdayParty 
classes  and  into  Party 


public  Party (int  numberOf People,  bool  fancyDecorations) 
this . fancyDecorations  =  fancyDecorations; 
this .NumberOf People  =  numberOf People; 


The  Party  Constructor  does 
everything  that  was  previously 
in  both  the  Dinnerparty  and 
BirthdayParty  Constructors 


private  int  numberOf People; 
public  virtual  int  NumberOf People  { 

get  (  return  numberOf People;  )  ^ _ 

set  { 

numberOf People  =  value; 

CalculateCostOf Decorations (fancyDecorations) , 


NumberOfPeople  needs  to  be  virtual 
because  BirthdayParty  needs  to  override 
it  (so  that  a  Change  to  the  number  of 
people  calculates  a  new  cake  size) 


public  void  CalculateCostOfDecorations  (bool  fancy)  (  The  decoration  calculation  is 

fancyDecorations  =  fancy;  identical  in  both  birthday  and 

if  (fancy)  dinner  parties,  so  it  makes  sense 

CostOfDecorations  =  (NumberOf People  *  15.00M)  +  50M;  ,  e  t  to  Party  That  way 

else  "'°j  ,,  ,  7.  -|ic>ted 

CostOfDecorations  =  (NumberOf People  *  7.50M)  +  30M;  r'or*  C  t0  C  ' 

I  in  multiple  classes. 


public  virtual  decimal  CalculateCost ()  { 

//  Each  person  costs  $25  for  food  plus  cost  of  beverages 

decimal  TotalCost  =  CostOfDecorations  +  (CostOfFoodPerPerson  *  NumberOfPeople) ; 
if  (NumberOfPeople  >  12) 


TotalCost  +=  100; 


return  TotalCost; 


ft-  The  Cost  calculation  needs  to  be  a  virtual  method 
birtday  party  overrides  it  (and  also 
extends  it  by  calling  the  base  class  method) 
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public  class  BirthdayParty  :  Party  { 
public  int  CakeSize; 

public  BirthdayParty (int  numberOf People,  bool  fancyDeco rat ions,  string  cakeWriting) 

:  base (numberOf People,  fancyDecorations)  {  a. 

CalculateCakeSize  () ;  [P  The  tonstruetor  relies  <*,  ^  ^  cjl 

this. CakeWriting  =  cakeWriting;  to  do  m©s-fc  of  -r-> 

CalculateCostOf Decorations  (fancyDecorations) ;  CaltulateCakeSiz^O  tl'k^th  ^ 

Ru_XL  J  a.  n>  f  I  ^ 


private  void  CalculateCakeSize ( )  ( 
if  (NumberOf People  <=  4) 

CakeSize  =  8; 

else 

CakeSize  =  16; 

} 

private  string  cakeWriting  = 
public  string  CakeWriting  ( 

get  (  return  this. cakeWriting;  ) 
set  ( 

int  maxLength; 
if  (CakeSize  ==  8) 
maxLength  =  16; 

else 

maxLength  =  40; 

if  (value. Length  >  maxLength)  { 


Mhd^ty^Wdid 


The  CaltulateCakeSizeO 

method  is  spetifit  to 
birthday  parties,  so  it  stays 
in  the  BirthdayParty  tlass. 


The  CakeWriting 
property  stays  intatt 
in  the  BirthdayParty 
tlass  too 


MessageBox. Show ("Too  many  letters  for  a 
if  (maxLength  >  this. cakeWriting. Length) 
maxLength  =  this. cakeWriting. Length; 
this. cakeWriting  =  cakeWriting. Substring (0,  maxLength) 
else 

this. cakeWriting  =  value; 


+  CakeSize  +  "  inch  cake") ; 


> 


( 


public  override  decimal  CalculateCost ( ) 
decimal  CakeCost; 
if  (CakeSize  ==  8) 

CakeCost  =  40M  +  CakeWriting. Length 

else 

CakeCost  =  75M  +  CakeWriting. Length 
return  base .CalculateCost ( )  +  CakeCost; 

} 


.  25M; 
.  25M; 


CalfulateCostO  also  needs  to  fee 
overridden,  betause  it  i 

first  taltulate  the  tost  of  the  take, 
and  then  add  it  to  the  tost  that  s 
emulated  -*  the  Party  tlass  s 
CaltidlateCostO  method 


public  override  int  NumberOf People  ( 

get  (  return  base. NumberOf People;  ) 
set  ( 

base. NumberOf People  =  value; 

CalculateCakeSize () ; 

this .CakeWriting  =  cakeWriting; 


} 


) 


The  Number  OfPeople  property  has  to 
override  the  one  in  Party  betause  the  set 
actcuor  needs  to  retaleulate  the  take 
Site  The  set  ateessor  needs  to  tall  base 
NumberOfPeople  so  that  the  set  attessor 
in  Party  also  gets  e*etuted 
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great  job! 


r 


^  Here's  the  last  class  in  Kathleen's  solution 
!  (TKere’s  no  ehany  to  the  -for""  Code  ) 

public  class  Dinnerparty  :  Party  ^,s  -field  is  only  used  in  dinner 

C)OLU"tiOH  {  parties,  not  birthday  parties,  so  it 

CONtlNuQp  public  decimal  CostOfBeveragesPerPerson;  stays  in  the  class. 

$ROM  P.33? 

public  DinnerParty (int  numberOf People,  bool  healthyOption, 

bool  fancyDecorations)  ^  ^  ^  oW 

:  base (numberOf People,  fancyDecorations)  {  ~  ,  .  did  the 

SetHealthyOption (healthyOption) ;  Dinnerrar  y 

CalculateCostOf Decorations  (fancyDecorations) ;  ne>w  Construe  C3  s 
)  Party  Constructor  and  then 

tails  SetHealthyOptionO. 

public  void  SetHealthyOption (bool  healthyOption)  { 
if  (healthyOption)  rr> 

CostOfBeveragesPerPerson  =  5.00M;  \ 

Glse  ^  ^  ^W«'VptionO  »,  il, 

CostOfBeveragesPerPerson  =  20.00M;  stays  exactly  the  san,e  th°“ 


public  decimal  CalculateCost (bool  healthyOption)  { 
decimal  totalCost  =  base. CalculateCost () 

+  (CostOfBeveragesPerPerson  *  NumberOf People) ; 

Dinnerparty  has  to  override 

if  (healthyOption)  CalCulateCostO-it  uses  the  base 

return  totalCost  *  .95M;  ^  ^  and  ^  *jds 

el"e  .  .  the  Cost  of  the  beverages  and  adds 

return  totalCost;  .  ,  , 

,  in  the  healthy  option  discount 


>y 

much! 
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Build  a  beehive  management  system 

A  queen  bee  needs  your  help!  Her  hive  is  out  of  control,  and 
she  needs  a  program  to  help  manage  it.  She’s  got  a  beehive  full 
of  workers,  and  a  whole  bunch  of  jobs  that  need  to  be  done 
around  the  hive.  But  somehow  she’s  lost  control  of  which  bee 
is  doing  what,  and  whether  or  not  she’s  got  the  beepower  to  do 
the  jobs  that  need  to  be  done. 

It’s  up  to  you  to  build  a  beehive  management  system  to  help 
her  keep  track  of  her  workers.  Here’s  how  it’ll  work: 


The  queen  assigns  jobs  to  her  workers 

There  are  six  possible  jobs  that  die  workers  can  do.  Some 
know  how  to  collect  nectar  and  manufacture  honey,  others 
can  maintain  the  hive  and  patrol  for  enemies.  A  few  bees  can 
do  every  job  in  the  hive.  So  your  program  will  need  to  give 
her  a  way  to  assign  a  job  to  any  bee  that's  available  to  do  it. 


*  Beehive  Management  System 


rVsis  dropdown  list  shows  dll  si*  jobs  that  the 
workers  Cdn  do  The  *\ueen  knows  whdt  jobs  need 
bo  be  done,  and  she  doesn’t  really  tare  which  bee 
does  each  job  So  she  just  selects  which  job  has  to 
be  done— the  program  will  figure  out  if  there  s  a 
worker  available  to  do  it  and  assign  the  job  to  him 


Worker  Bee  Job  Assignments 
Worker  bee  job 

H :  rey  rrenutr.-aunnj 

^ t 

— j —  Assign  this  |ob  to  e  bee  -5 — 

l~  l  \  \  \ 


If  there's  a  bee 
available  to  do  the  job, 
the  program  assigns 
the  job  to  the  bee  and 
lets  the  <\ueen  know^^ 
it’s  taken  care  of 


j/  The  bees  work  shifts, 

and  most  jobs  require 
more  than  one  shift 
M  So  the  <\ueen  enters 
i  W  the  number  of  shifts 

Z  A  the  job  will  take,  and 
W  clicks  the  "Assign 
4  this  job”  button 


The  Job  Honey  manufacturng'  wtl  be  done  in  3  shifts 


When  the  jobs  are  all  assigned,  it’s  time  to  work 

Once  the  queen’s  done  assinging  the  work,  she’ll  tell  the  bees  to  work  the  next 
shift  by  clicking  the  “Work  the  next  shift"  button.  The  program  then  generates 
a  shift  report  that  tells  her  which  bees  worked  that  shift,  what  jobs  they  did,  and 
how  many  more  shifts  they'll  he  working  each  job. 


rx  \  a 

s  ■  Work  the  J— 
_  next  shift 

L_i_i 


help  the  queen 


First  you'll  build  the  basic  system 


This  project  is  divided  into  two  parts.  The  first  part  is  a  hit  of  a  review; 
where  you'll  create  the  basic  system  to  manage  the  hive.  It’s  got  two  classes. 
Queen  and  Worker.  You’ll  build  the  form  for  the  system,  and  hook  it  up  to 
the  two  classes.  And  you’ll  make  sure  the  classes  are  well  encapsulated  so 
they’re  easy  to  change  when  you  move  on  to  the  second  part. 


Queen 

private  workers:  Workerfl 
private  shiftNumber:  int 


AssignWork() 

WorkTheNextShift() 


CurreivtOob  and  ShiftsLeVtav* 


read-only  properties 


Worker 

CurrentJob:  string 
ShiftsLeft:  int 

private  jobsICanDo:  stringQ 
private  shiftsToWork:  int 
private  shiftsWorked:  int 

DoThisJob() 

WorkOneShift() 


Sometimes  class  diagrams 
list  private  -fields  and  types 

The  program  has  one  Queen  object  that  manages  the  work  being  done. 

*  The  Queen  uses  an  array  of  Worker  objects  to  track  each  of  the 
worker  bees  and  whether  or  not  those  l>ees  have  been  assigned  jobs. 
It’s  stored  in  a  private  Worker[]  field  called  worker. 

*  The  form  calls  the  Assign Work()  method,  passing  a  string  for  the 
job  that  needs  to  be  performed  and  an  int  for  the  number  of  shifts. 
It’ll  return  true  if  it  find  a  worker  to  assign  the  job  to,  or  false  if  it 
couldn’t  find  a  worker  to  do  that  job. 

*  The  form’s  “Work  the  next  shift"  button  calls  WorkTheNextShift0, 
which  tells  the  workers  to  work  and  returns  a  shift  report  to  display. 
It  tells  each  Worker  object  to  work  one  shift,  and  then  checks  that 
worker’s  status  so  it  can  add  a  line  to  the  shift  report. 

The  queen  uses  an  array  of  Worker  objects  to  keep  track  of  till  of  the 
workers  and  what  jobs  they’re  doing 

*  CurrentJob  is  a  read-only  property  that  tells  the  Queen  object  what 
job  the  worker's  doing  (“Sting  patrol”,  “Hive  maintenance”,  etc.) 

If  the  worker  isn’t  doing  any  job,  it’ll  return  an  empty  string. 

*  The  Queen  object  attempts  to  assign  a  job  to  a  worker  using  its 
DoThisJobQ  method.  If  that  worker  is  not  already  doing  the  job, 
and  if  that’s  a  job  that  he  knows  how  to  do,  then  lie’ll  accept  the 
assignment  and  the  method  returns  true.  Otherwise,  it  returns  false. 

*  When  the  WorkOneSliiftQ  method  is  called,  the  worker  works  a 
shift.  He  keeps  track  of  how  many  shifts  are  left  in  the  current  job. 
If  the  job  is  done,  then  he  resets  his  current  job  to  an  empty  string 
so  that  he  can  take  on  his  next  assignment. 


£Vmg.|s/Vu!IOv-Emp'tyO 

Since  each  bee  stores  its  Current  job  as  a  string,  the  way  the  worker  knows 
whether  or  not  hes  not  Currently  doing  a  job  is  to  Check  it  bis  CurrentJob 
froperty-'t  II  be  egual  to  an  empty  string  it  be's  waiting  tor  bis  next  job.  C# 
res  you  an  easy  way  to  do  that  Str.nglsNullCVEmpt/CurrentJob)  will  return 
true  if  tbe  CurrentJob  string  is  either  empty  or  null,  false  otherwise- 
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A  queen  bee  needs  your  help!  Use  what  you've  learned  about  classes  and  objects  to  build  a 
beehive  management  system  to  help  her  track  her  worker  bees. 


O  Build  the  form 

The  form  is  pretty  simple — all  of  the  intelligence  is  in  the  Queen  and  Worker  classes.  The  form 
has  a  private  Queen  field,  and  two  buttons  call  its  Assign Work()  and  WorkTheNextShiftQ  methods. 
You'll  need  to  add  a  ComboBox  control  lor  the  bee  jobs  (llip  back  to  the  previous  page  to  see  its  list 
items),  a  NumericUpDown  control,  two  buttons,  and  a  multiline  textbox  lor  the  shift  report.  You'll 
also  need  the  form’s  constructor — it’s  below  the  screenshot. 

This  is  a  ComboBox.  Control  The  nexKhi-Pf  huTU 


named  woekeeBeeJob  Use 
rfcs  Items  property  to  ^ 
set  the  list,  and  set  its 
PropDownStyle  property 
to  "PiropPownList  so 
the  user  is  only  allowed 
to  tboose  items  from  the 
list  The  Shift*  boit  is  a 

KumericUpPown  Control 

called  shifts- 


Name  this  text  box  "report  | 
and  set  its  /VJultiLine 
property  to  true  s — ^ 


Worker  Bee  Job  Assignments 

Worker  bee  job 

I  Hive  maintenance  ' 

Assign  this  job  to  a  bee 


Work  the 
next  shift 


Report  for  shift  #21 

Worker  #1  is  doing  Nectar  collector  for  2  more  shifts 
Worker  #2  is  doing  Baby  bee  tutoring'  for  1  more  shifts 
Worker  #3  finished  the  job 
Worker  #3  is  not  working 

Worker  #4  will  be  done  with  Hive  maintenance'  after  this  shift 


The  nextShift  button 
calls  the  queen's 
WbrkTheNextShiftO 
method,  which  returns  a 
string  that  Contains  the 
shift  report 

Look  closely  at  this 
I  shift  report,  which  the 
Queen  object  generates- 
It  starts  with  a  shift 
s  number,  and  then  reports 
[  what  eath  worker  is  doing 
\  Use  the  escape  sequences 
KrV  to  add  a  line  break 
in  the  middle  of  a  string 


public  FormlO  {  Bach  Worker  object’s  Constructor  takes  one 

InitializeComponent () ;  parameter,  an  array  of  strings  that  tell  it 

Worker!]  workers  =  new  Worker  [4];  what  jobs  it  knows  how  to  do 

workers  [0]  =  new  Worker  (new  string!]  {  "Nectar  collector",  "Honey  manufacturing'' 

workers [1]  =  new  Worker (new  string!]  !  "Egg  care",  "Baby  bee  tutoring"  )); 

workers[2]  =  new  Worker(new  string!]  {  "Hive  maintenance",  "Sting  patrol"  }); 

workers [3]  =  new  Worker (new  string!]  (  "Nectar  collector",  "Honey  manufacturing" 

"Egg  care",  "Baby  bee  tutoring",  "Hive  maintenance",  "Sting  patrol" 


workers [3]  =  new  Worker (new  string!]  (  "Nectar  collector",  "Honey  manufacturing", 

"Egg  care",  "Baby  bee  tutoring",  "Hive  maintenance",  "Sting  patrol"  )) 
queen  =  new  Queen (workers) ; 

You*-  form  will  »eed  a  Queen  field  called  gueen  You’ll  pass  -that  away 
^  ^  of  Worker  object  references  to  the  Queeh  object's  Constructor 

)  Build  the  Worker  and  Queen  classes 

You’ve  got  almost  everything  you  need  to  know  about  the  Worker  and  Queen  classes.  There  are 
just  a  couple  more  details.  Queen. Assign WorkQ  loops  through  the  the  Queen  object’s  worker 
array  and  attempts  to  assign  the  job  to  each  Worker  using  its  DoThisJobO  method.  Hie  Worker 
object  checks  its  jobsICanDo  string  array  to  see  if  it  can  do  the  job.  If  it  can,  it  sets  its  private 
shiftsToWork  field  to  the  job  duration,  its  Current  Job  to  the  job,  and  its  shiftNumber  to  zero. 

When  it  works  a  shift,  it  decreases  shiftNumber  by  one.  The  read-only  ShiftsLeft  properly  returns 
shiftsToWork  -  shiftsWorked  the  queen  uses  it  to  see  how  many  shifts  are  left  on  the  job. 
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EmciSe 

§0(.yt\0M 


public  class  Worker  {  £ 

public  Worker (string []  jobsICanDo)  { 
this . jobs ICanDo  =  jobsICanDo; 

> 


ShiftsLeft  is  a  read-only 
property  that  daldulates  — 
how  many  shifts  are  left 
on  "the  durrent  job 

Cur  rent  Job  «  a  read¬ 
only  property  that 

tells  the  v“" 
y>b  needs  to  be  done- 


public  int  ShiftsLeft  { 

?  get  { 

return  shiftsToWork  -  shiftsWorked; 

} 

} 

>private  string  currentJob  = 
public  string  CurrentJob  { 
get  { 

return  currentJob; 

) 

I 

private  string!]  jobsICanDo; 
private  int  shiftsToWork; 
private  J  nt  shiftsWorked; 


The  donstrudtor  just 
sets  the  Jobs/CanDo 
property,  whidh  is  a 
string  array.  |t's  private 
bedause  we  want  the 
<\ueen  to  ask  the  worker 
to  do  a  job,  rather  than 
•*^ke  her  dhedk  whether 
he  knows  how  to  do  it- 


The  gueen  uses  the  worker's  j 
DoThisJobO  method  to  assign 
work  to  him-he  dhedks  his 
Jobs/CanDo  property  to  see  if 
he  knows  how  to  do  the  job 


public  bool  DoThis Job (string  job,  int  numberOf Shifts) 

if  ( ! String . IsNullOrEmpty (currentJob) )  <T - ^ 

return  false; 

for  (int  i  =  0;  i  <  jobsICanDo . Length;  i++) 

*  if  (jobsICanDo [i]  ==  job)  { 

currentJob  =  job; 

this . shiftsToWork  =  numberOfShifts; 
shiftsWorked  =  0;  d  NOT  ope* 

return  true; 


return  false; 


VVe  used  the  NOT  operator-to 
dhedk  i-f  the  string  is  NOT  null  or 
empty  It's  just  like  dhedk.ng  to  see 

if  something’s  false 


The  gueen  uses  the  worker  s 
WorkOneShiftO  method  to 
tell  him  to  work  the  ne*t 
shift  The  method  only 
returns  true  if  'this  is  the 
very  last  shift  that  he  s 
doing  the  job  That  way  the 
gueen  dan  add  a  line  to  the 
report  that  the  bee  will  be 
done  after  this  shift 


public  bool  WorkOneShiftO  { 

if  (String. IsNullOrEmpty (current Job) ) 
return  false; 
shiftsWorked++; 

if  (shiftsWorked  >  shiftsToWork)  ( 
shiftsWorked  =  0;  i 

shiftsToWork  =  0;  Take  3  close  lo 

currentJob  =  dhedks  the  duv 

return  true;  _ 


return  false; 


0*.  Take  a  dlose  look  at  the  logid  here-  First  rt 
;  dhedks  the  durrentJob  field-'  if  the  worker's 

not  working  on  a  job,  it  just  returns  false, 
whidh  stops  the  method  |f  not,  then  it 
^  indrements  ShiftsWorked,  and  then  dhedks 
*  to  see  if  this  is  the  job's  done  by  domparing 

it  with  ShiftsToWork.  |f  it  is,  the  method 
returns  true  Otherwise  it  returns  false 
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public  class  Queen  { 

public  Queen (Worker [ ]  workers) 
this. workers  =  workers; 

) 


private  Worker []  workers; 
private  int  shiftNumber  = 


0; 


{  TV  «\ueen  keeps  Vr  array  of  workers  frwate 
because  onee  they’re  assigned,  no  other  class 
should  be  able  to  thange  them.  or  even  see 
the-,  smCe  she's  the  only  one  who  ^es  the"" 
orders.  The  Constructor  sets  the  Helds  value. 


public  bool  AssignWork (string  job,  int  numberOf Shifts)  ( 
for  (int  i  =  0;  i  <  workers. Length;  i++) 

if  (workersli] .DoThisJob ( job,  numberOfShifts) ) 
return  true;  iv  . 

return  false;  V  He  a“'9''S  WO,rk  ^  ^es,  she  s^fts  With 

1  7* .7"f  °*e  assigning  him  the  job.  If  he  Can't 

public  string  WorkTheNextShif t  ()  1  ±l  •  £°^.  T,  next  When  a  bee  who  Can  do 

shiftNumber++;  J  IS  ow'"'  the  method  returns  (which  stops  the  loop) 

v  string  report  =  "Report  for  shift  #"  +  shiftNumber  +  "\r\n"; 
for  (int  i  =  0;  i  <  workers. Length;  i++) 

7Te  Queens  if  (workersli] . WorkOneShift () ) 

WorkTheWext£hi-P+()  report  +=  "Worker  #"  +  (i  +  1)  +  "  finished  the  job\r\n"; 

,  j,  ,  .  ^ ''if  (String.  IsNullOrEmpty  (workers  [  i  J  .CurrentJob) ) 

n'e  od  tells  each  report  +=  "Worker  #"  +  (i  +  1)  +  "  is  not  working\r\n"; 

else 

if  (workers [i] .ShiftsLeft  >  0) 

report  +=  "Worker  #"  +  (i  +  1)  +  "  is  doing  +  workers [i] .CurrentJob 
+  for  ”  +  workers [i] .ShiftsLeft  +  "  more  shifts\r\n"; 

else 

report  +=  "Worker  #"  +  (i  +  1)  +  ”  will  be  done  with 

+  workers [i] .Current Job  +  after  this  shift\r\n"; 


r* 


worker  to  work  j 
Shi-Pt  and  adds  j 
line  to  the  report 
depending  on  the 
worker's  status. 


] 

return  report; 

}  The  form  uses  its  <\ueen  -field  to 

keep  a  reference  to  the  <$ueen 

We  already  gave  you  the  constructor.  Here’s  the  rest  of  the  code  for  the  form:  obiect,  which  in  turn  has  an  array 
Queen  queen;  ^  of  references  to  the  worker  objects 

private  void  assign Job_Click (object  sender,  EventArgs  e)  ( 

if  (queen .AssignWork (workerBeeJob. Text,  (int) shifts. Value)  ==  false) 
MessageBox.Show ("No  workers  are  available  to  do  the  job  '* 

+  workerBeeJob. Text  +  "The  queen  bee  says..."); 

else 

MessageBox.Show ("The  job  +  workerBeeJob. Text  +  will  be  done  in 
+  shifts. Value  +  ”  shifts",  "The  queen  bee  says..."); 

The  assignJob  button  calls  the 
gueen's  ^ssignkVbrkO  method  to 
assign  work  to  a  worker,  and 
displays  a  messagebox  depending 
on  whether  or  not  a  worker’s 
available  to  do  the  job 


) 

private  void  nextShif t_Click (object  sender,  EventArgs  e)  ( 
report. Text  =  queen. WorkTheNextShif t () ; 

r n,,  t  ww  t»  '“'>rk  **  “‘i  *’ft  sv" 

C-  a  «Fo.t  It  »  t>«  «f-t  t««t  to* 
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you’re  not  done 


Objectcross 

Before  you  move  on  to  the  next  part  of  the  exercise, 
give  your  brain  a  break  with  a  quick  crossword. 


Across 

5.  This  method  gets  the  value  of  a  property. 

7.  This  method  returns  true  If  you  pass  it 

8.  The  constructor  in  a  subclass  class  doesn’t  need  the  same 
_ as  the  constructor  in  its  base  class. 

9.  A  control  on  a  form  that  lets  you  create  tabbed  applications 
11  This  type  of  class  can't  be  instantiated. 


Down 

1  A _ can  override  methods  from  its  base  class 

2.  If  you  want  a  subclass  to  override  a  method,  mark  the 
method  with  this  keyword  in  the  base  class. 

3.  A  method  in  a  class  that's  run  as  soon  as  it’s  instantiated. 

4  What  a  subclass  does  to  replace  a  method  in  the  base 
class. 

6.  This  contains  base  classes  and  subclasses 

7.  What  you're  doing  when  add  a  colon  to  a  class  declaration. 

1 0.  A  subclass  uses  this  keyword  to  call  the  members  of  the 
class  it  inherited  from. 


**  Answers  on  page  250. 
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Use  inheritance  to  extend  the 
bee  management  system 

Now  that  you  have  the  basic  system  in  place,  use  inheritance  to  let  it  track  how  much 
honey  each  bee  consumes.  Different  bees  consume  different  amounts  of  honey,  and 
the  queen  consumes  the  most  honey  of  all.  So  you'll  use  what  you’ve  learned  about 
inheritance  to  create  a  Bee  base  class  that  Queen  and  Worker  inherit  from. 


rsD-V 


/TT 


Add  .t* .  - 

V.OU  *a*t  to  add  The  IDE  "'ake  ne>N  ^  ^th  out  $<*,  though-  I  he 

and  add  the»  to  the  project  There  are  a  V  ^  eath  class  file  and  cha«y  >ts 

ipe  W.II  NOT  cha*y  the  ^esyate,  so  70U  ^  add  ,ts  des.yer  (.pe»^- 


we’re  all  just  bees 


We  re  not  done  yet!  The  queen  needs  to  keep  track  of  how  much  honey  the  hive  is  spending  on 
its  workers.  Here's  a  perfect  chance  to  use  your  new  inheritance  skills! 

O  The  queen  needs  to  know  how  much  honey  the  hive  uses 

The  queen  just  got  a  call  from  her  accountant  trees,  who  told  her  that  the  hive  isn’t  producing  enough 
honey.  She’ll  need  to  know  how  much  honey  she  and  her  workers  are  using  so  she  can  decide  whether  to 
divert  workers  from  egg  maintenance  to  honey  production. 

*  All  bees  eat  honey,  so  the  hive  runs  through  a  lot  of  honey.  That’s  why  they  need  to  keep  making 
more  of  it. 

*  Worker  bees  use  more  honey  when  they’re  working.  They  need  the  most  honey  when  die  job 
starts,  to  give  them  plenty  of  energy  for  the  job,.  They  consume  less  and  less  as  the  job  goes  on. 
On  the  last  shift  the  bee  uses  10  units  of  honey,  the  second-to-last  shift  lie  uses  1 1  units,  the  shift 
before  that  he  uses  12  units,  etc.  So  if  the  bee’s  working  (meaning  its  Shil’tsLeft  is  greater  than 
zero),  then  you  can  find  out  how  many  units  of  honey  to  consume  by  adding  9  to  ShiftsLcft. 

*  If  a  bee  doesn’t  have  a  job  (i.e.,  its  ShiftsLeft  is  zero),  he  only  uses  7.5  units  of  honey  for  the  shift. 

*  Those  numbers  are  all  for  normal  bees.  If  a  bee  weighs  over  150  milligrams,  it  uses  35 %  more 
honey.  This  includes  both  workers  and  queens. 

*  Queens  require  a  lot  of  honey.  A  queen  uses  more  honey  when  she’s  got  more  workers  doing 
jobs,  because  it’s  a  lot  of  work  overseeing  them.  She  needs  to  consume  as  much  honey  as  if  she’d 
worked  as  many  shifts  as  die  worker  with  the  most  shifts  left  on  his  job. 

*  Then  she  needs  even  more  honey:  she  uses  20  extra  units  of  honey  per  shift  if  there  are  2  or  fewer 
workers  working,  or  30  extra  units  of  honey  if  there  are  3  or  more  w  orker  bees  doing  jobs.  The 
queen’s  consumption  isn’t  subject  to  the  35%  rule,  since  all  queens  weigh  275  milligrams. 

*  The  queen  needs  all  the  honey  consumption  numbers  added  to  the  end  of  each  shift  report. 


Create  a  Bee  class  to  handle  the  honey  calculations 

Since  the  workers  and  queen  all  do  their  honey  calculations  in  similar  ways,  you’ll  be  able  to  avoid 
duplicating  your  code  by  having  a  Bee  base  class  dial  Worker  and  Queen  can  inherit  from.  You  know 
that  each  bee  needs  to  know  its  weight  (so  it  knows  whether  to  multiply  its  honey  expenditure  by  35%). 


m 


* 


* 

* 


Create  a  CetHoneyConsuinptionf)  method  that  calculates  the  amount  of  honey  that  a  worker 
uses.  Since  the  workers  and  queen  all  need  to  do  this  calculation  but  the  queen  needs  to  do  extra 
calculations  as  well,  it  makes  sense  for  the  worker  to  inherit  it  and  the  queen  to  override  it. 

The  GetHoneyConsumption{)  method  needs  the  number  of  shifts  left,  so  add  a  virtual  read-only 
property  called  ShiftsLeft  that  returns  zero.  The  worker’s  ShiftsLeft  will  override  it. 


The  honey  consumption  calculation  needs  to  know  the  bee’s  weight,  so  the  Bee  constructor  will 
need  to  take  the  weight  as  a  parameter  and  store  it  in  a  field.  Since  no  other  class  needs  to  use  it, 
you  should  make  it  private.  Here's  a  good  rule  of  thumb.  You  should  make  f  ields  and  methods 

private  by  default,  and  only  make  them  public  i-f  another  class  needs 
them.  That  *<ay  you  avoid  bugs  in  your  programs  caused  by  one  class 
_ accessing  another  class's  properties  or  methods  incorrectly _ 
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Make  the  Worker  class  inherit  from  Bee 

You’ll  need  to  set  up  the  constructor  to  call  the  base  class  constructor,  like  you  did  with 
Kathleen.  You'll  need  to  change  the  Worker  constructor  so  dial  it  hikes  the  bee's  weight  as 
a  parameter,  and  pass  that  parameter  on  to  the  base  class  constructor.  Then,  just  add  the 
override  keyword  to  the  Worker’s  ShiftLeft  method.  Once  you  do  that,  each  worker  will 
be  able  to  calculate  his  honey  consumption  for  the  queen...  and  you  don't  have  to  make  any 
more  changes  to  the  Worker  class! 


Make  the  Queen  class  inherit  from  Bee 

The  Queen  class  needs  a  little  more  alteration  than  the  Worker  class,  since  she  needs  to  actually  do  the 
honey  calculation  and  add  it  to  the  shift  report. 

*  Override  the  Bec.GetHoneyConsumptionO  method  and  add  the  queen’s  extra  calculation.  She’ll 
need  to  figure  out  whether  she  has  2  or  fewer  workers  with  jobs,  so  she  knows  whether  she  needs 
20  or  30  units.  Then  she’ll  need  to  add  that  to  the  number  of  units  she'd  use  if  she  had  the  same 
number  of  shifts  left  as  the  worker  w  ith  the  most  shifts  left. 

*  Update  the  queen’s  WorkTheNextShiftQ  by  adding  the  a  honey  consumption  line  to  the 
report.  Add  a  loop  to  add  up  the  honey  consumptions  for  each  worker  and  also  find  the  worker 
with  the  largest  honey  consumption  do  it  before  the  queen  tells  each  worker  to  work  each 
shift  (so  she  gets  the  consumption  numbers  for  the  current  shift).  She’ll  add  those  up,  add  her 
own  consumption,  and  then  add  a  line  to  the  end  of  the  shift  report  that  says,  “Total  Honey 
Consumption:  xxx  units’’  (where  xxx  is  the  number  of  units  of  honey  consumed). 

*  You'll  need  to  update  the  Queen  constructor  just  like  you  did  for  Worker. 


6\o  { o  -the  Queen  class  and  type  "public 
override"— when  you  press  -the  space  / 
bar,  -the  IDE-  automatically  lists  all  the 
methods  you  can  override  Select  the 
method  you  want  to  override  and  it'll  f  ill 
in  the  base  method  call  automatically 


Ipubiic  override  1 

•  Equifc  (object  ctoj) 

Update  the  form  to  instantiate  the  bees  properly 

Since  you  changed  the  Queen  and  Worker  constructors,  you’ll  also  need  to  change  the  way  they're  called. 
Each  constructor  has  a  new  Weight  parameter,  so  you’ll  need  weights  to  use: 

*  Worker  Bee  #1:1 75mg:  Worker  Bee  #2:  1 14mg:  Worker  Bee  #3:  149mg; 

Worker  Bee#4:  155mg;  Queen  Bee:  275mg 

That’s  the  only  change  you’ll  need  to  make  to  the  form! 
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EmaSe 

Solution 


"*'•  **  H <k*<  tk,  b**  k„,y 

thT^  "^'b“  tw'‘  by  Wk 

the  Worker  and  <$uee*  classes. 


public  class  Bee  { 

public  Bee (double  weight)  { 
this. weight  =  weight,^' 


public  virtual  int  ShiftsLeft 
get  {  return  0;  ) 

) 

private  double  weight; 


TKe  Bee  class  has  a  Constructor 
tKat  sets  its  Weight  field  and 
a  ^oh<y Consumption^ )  method 
that  calculates  how  much  honey 
a  worker  Consumes. 


public  virtual  double  GetHoneyConsumption 0  {  .  ,.pi 

double  consumption;  "y  if  a  bee  has  s  1 

if  (ShiftsLeft  ==  0)  left  be  Consumes  IO, 

consumption  =  7.5;  \  if  X  left  be  Consumes 

else  \  ||,  et*  if  be  has  no  job, 

consumption  =  9  +  ShiftsLeft;  J  Consumes  I* 

if  (weight  >  150)  CKiflit-ef t «  **'ro<  the 

consumption  *=  1.35;  the  bee  has  no  job- 

return  consumption;  ,[  ,  , 

+  the  bee  weighs  more  than 
,  0mg,  then  Consumption 
Joes  up  by  35%. 


Inheritance  made 
it  easy  {or  you  to 
update  your  code 
and  add  the  new 
honey  consumption 
behavior  to  the 
Queen  and  Worker 
classes.  It  would 
have  been  a  lot 
harder  to  make 
this  change  il 
you’d  had  a  lot  ol 
duplicated  code. 


public  Forml ( )  ( 

InitializeComponent () ; 


"  °*j[  *re,forT  £on*t»r‘*ctor  changed— the 
>"  res^  °f  ^he  -form  is  exactly  the  same. 


Worker!]  workers  =  new  Worker [4];  _ 

workers[0]  =  new  Worker (new  string!]  {  "Nectar  collector",  "Honey  manufacturing"  ) , Q7 

workers[l]  =  new  Worker (new  string!]  (  "Egg  care",  "Baby  bee  tutoring"  ) ,  Cll4)V 

workers [2]  =  new  Worker (new  string!]  (  "Hive  maintenance",  "Sting  patrol"  >7 <^49~fy 

workers!3]  =  new  Worker(new  string!]  I  "Nectar  collector",  "Honey  manufacturing", _ 

"Egg  care",  "Baby  bee  tutoring",  "Hive  maintenance",  "Sting  patrol"  ) ,  nJ>5)); 
queen  =  new  Queen (workers) ; 

The  only  Change  to  the  form  is  that  the 
weights  need  to  be  added  to  the  Worker 
Constructors 
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public  classfWorker  ;  Bee>y  { 

public  Worker (string [ ]  jobsICanDo,  int  weight) 
:  base (weight)  { 
this .jobsICanDo  =  jobsICanDo; 

} 

public .override  int  ShiftsLeft  ( 

//  ...  the  rest  of  the  class  is  the  same  . . . 


•fe*rLeb“  ""dtd **■ 

*  oh  to  base  class  to 

the  B<earfbUf*  prepay 

y  adding  the  override  keyword  to  the  y 

Property  declaration 


The  ($ueen  class  needed  a  few  changes, 
starting  with  inheriting  from  Bee- 

public  class  Queen  :  Bee  I  Tbe  gueen  weighs  Zl^o,  so  her  Constructor 

public  Queen  (Worker  [  ]  workers )  M,u  the  base  ^  torisWtor  and  passes  *  a 
:  base  (275)  (  weight  of  r?* 


this. workers  =  workers; 


public  string  WorkTheNextShift  ( )  1/  'wo'r*er  s  qeiHoneyConsumptiohO 

(  ^eiKod,  and  then  calls  her  own 

double  totalConsumption  =  0;  qetrtoneyConsumptionO  method  to 

for  (int  i  =  0;  i  <  workers . Length;  i++)  ^o^e  up  with  a  total  Consumption 
totalConsumption  +=  workers [i] .GetHoneyConsumption () ; 
totalConsumption  +=  GetHoneyConsumption () ; 

//  ...  here's  where  the  orignal  code  for  this  method  goes 


C,  report  +=  ''Total  honey  consumption:  "  +  totalConsumption  +  "  units"; 
return  report; 

The  rest  of  WbrkTheNe*t£hiftO  is  the  same,  . - The  gueen  overrides  the  Bee's 

except  that  it  adds  the  honey  line  to  the  report-  ^  GetHoneyConsumption^ )  method  to 

public  override  double  GetHoneyConsumption  ( )  1  do  her  honey  calculation  It  finds  the 
double  consumption  =  0;  worker  with  the  largest  Consumption 

double  largestWorkerConsumption  =  0;  ah<^  adds  either  20  or  10  to  it  based 

int  workersDoingJobs  =  0;  or'  many  workers  are  working. 


This  loop 
looks  at  the 

Consumption 

of  all  the 

workers  and 
f  inds  the 
one  with 
the  largest 


public  override  double  GetHoneyConsumption  ()  (  “  ner  noney  calculation  It  fine 

double  consumption  =  0;  worker  with  the  largest  Consumj 

double  largestWorkerConsumption  =  0;  ^  adds  either  20  or  10  Ax,  \{ 

int  workersDoingJobs  =  0;  or'  many  workers  are  workin 

^  for  (int  i  =  0;  i  <  workers .Length;  i++)  { 

if  (workers [i] .GetHoneyConsumption ()  >  largestWorkerConsumption) 
the  largestWorkerConsumption  =  workers [ i ] .GetHoneyConsumption () ; 

ion  if  (workers [i] .ShiftsLeft  >  0) 

ie  workersDoingJobs++; 


finds  the  consumption  +=  largestWorkerConsumption; 
one  with  if  (workersDoingJobs  >=  3) 

the  largest  consumption  +-  30;  V.  |f  there  are  3  or  more  workers 

Consumption  else  Ny  doing  jobs,  the  gueen  needs  10 

consumption  +=  20;  more  units  of  honey,  otherw.se, 

return  consumption;  ,  _ 


she  needs  20  more  units- 


you  are  here  ► 
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crossword  solution 


Objectcross  Solution 
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7  interfaces  nncl  n^strnct  classes 

%  +  Making  classes 

keep  their  promises 


Okay,  okay,  I  know  I  implemented 
the  BookieCustomer  interface, 
but  I  can't  code  the  PayMoneyO 
method  until  next  weekend. 


You've  got  three  days  before 
I  send  some  Thug  objects  by  to 
make  sure  you  implement  the 
WalksWithALimpQ  method. 


Actions  speak  louder  than  words. 

Sometimes  you  need  to  group  your  objects  together  based  on  the  things  they  can 
do  rather  than  the  classes  they  inherit  from.  That's  where  interfaces  come  in — they 
let  you  work  with  any  class  that  can  do  the  job.  But  with  great  power  comes  great 
responsibility,  and  any  class  that  implements  an  interface  must  promise  to  fulfill  all  of 
its  obligations ...  or  the  compiler  will  break  their  kneecaps,  see? 


this  is  a  new  chapter 
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worker  bees,  unite! 


let's  get  back  to  bee-sics 

The  General  Bee-namics  corporation  wants  to  make  the 
Beehive  Management  System  you  created  in  the  last  chapter 
into  a  full-blown  Hive  Simulator.  Here’s  an  overview  of  the 
specification  for  the  new  version  of  the  program: 


fTp.np.nal  Bee-namics  Hive  Sim(jlator__ 

To  better  represent  life  in  the  hive,  well  need  to  add  specialized 
capabilities  to  the  worker  bees. 

Ml  bees  consume  honey  and  have  a  weight. 

-  Queens  assign  work,  monitor  shift  reports,  and  tell  workers  to 
work  the  next  shift . 

>  Ml  worker  bees  work  shifts. 

.  Sting  patrol  bees  will  need  to  be  able  to  sharpen  their  stingers, 
look  for  enemies,  and  sting  them. 

.  Nectar  collector  bees  are  responsible  for  finding  flowers, 
gathering  nectar  and  then  returning  to  the  hive. 


I  a»d  Worker 

^  M  l°°k  like 

^  extend  -the 
dasses  ne  already 

h*»dle  these 
Mew  natures. 


Looks  like  well  heed  to  be  able  to  J 
store  different  data  for  the  worker 
bees  defending  on  the  job  they  do. 


Lots  of  things  arc  still  the  same 

The  bees  in  the  new  hive  simulator  will  still  consume  honey  in 
the  same  way  they  did  before.  The  queen  still  needs  to  be  able 
to  assign  work  to  the  workers  and  see  the  shift  reports  that 
tell  who’s  doing  what.  The  workers  work  shifts  just  like  they 
did  before,  too,  it’s  just  that  the  jobs  they  are  doing  have  been 
elaborated  a  little  bit. 
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interfaces  and  abstract  classes 


We  caw  use  inheritance  to  create 
classes  for  different  types  of  bees 


Here’s  a  class  hierarchy  with  Worker  and  Queen  classes  that 
inherit  from  Bee,  and  Worker  has  subclasses  NectarCollector 
and  StingPatrol. 


Here's  where 

about 

^  weigh*  and  honey 
Consumption  is  stored 


Here's  where  all 

°f  '•’'formation 

about  working  shifts 
,s  kept. 


Bee 


Weight 


HoneyConsumptionQ 


Job 

ShiftsToWork 

ShiftsWorked 

ShiftsLeft 

DoThisJobf) 

WorkOneShiftQ 


Remember  how  the  gueen 
■reeded  extra  honey?  Here's 
where  we  overrode  her 
noneyConsumptionO  method. 


This  is  what  the  new 
subclasses  will  look  like- 

StingPatrol 


class 


StingPatrol  and 

^  Worker  class. 

/ 


Worker 


AssignWorkf) 

WorkTheNextShift() 

HoneyConsumptionQ 


int  StingerLength; 
bool  enemyAlert; 

public  bool  SharpenStinger  (int  Length) 

{  .  .  .  1 

public  bool  LookForEnemies (){...} 
public  void  Sting (string  Enemy) {... } 


/  \ 
NprtarHt 


StinqPatrol 

NectarCollector 

StingerLength 

EnemyAlert 

Nectar 

Sharpen  Sti  nger() 

FindFlowers() 

LookForEnemies() 

GatherNectar() 

Sting() 

ReturnToHiveQ 

V  ^  ^bese  classes 

bold  the  information 
particular  to  each  job. 


class  NectarCollector  :  Worker 

{ 

int  Nectar; 

public  void  FindFlowers  (){...} 
public  void  GatherNectar (){...} 
public  void  ReturnToHive (){...} 

1 


What  happens  if  you  have  a  bee  that 
needs  to  sting  and  collect  nectar? 


you  are  here  ► 
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interfaces  for  jobs 

Ah  interface  tells  a  class  that  it  must  implement 
certain  methods  and  properties 

A  class  can  only  inherit  from  one  other  class.  So  creating  two  separate  subclasses  for 
the  StingPatrol  and  NectarCollector  bees  won’t  help  us  if  we  have  a  bee 
that  can  do  both  jobs. 

The  queen’s  DefendTheHiveQ  method  can  only  tell 
StingPatrol  objects  to  keep  the  hive  safe.  She’d  love  to  train 
the  other  bees  to  use  their  stingers,  but  she  doesn’t  have 
any  way  to  command  them  to  attack: 


public  class  Queen  { 

private  void  DefendTheHive (StingPatrol  patroller)  {  ...  } 

} 


You  use  an 
interlace  to 
require  a  class 
to  include  all 
of  tke  metkods 
and  properties 
listed  inside  tke 
interlace— ii 
it  doesn’t,  tke 
compiler  will 
tli  row  an  error. 


There  are  NectarCollector  objects  that  know  how  to  collect  nectar  from  flowers,  and 
instances  of  StingPatrol  that  can  sharpen  their  stingers  and  patrol  for  enemies.  But  even 
if  the  queen  could  teach  the  NectarCollector  to  defend  the  hive  by  adding  methods  like 
SharpenStinger()  and  LookForEnemies()  to  its  class  definition,  she  still  couldn’t  pass  it 
into  her  DefendTheHiveQ  method.  Maybe  she  could  use  two  different  methods: 


private  void  DefendTheHive (StingPatrol  patroller); 

private  void  AlternateDefendTheHive (NectarCollector  patroller) ; 


But  that’s  not  a  particularly  good  solution.  Both  of  those  methods 
would  be  identical,  because  they’d  call  the  same  methods  in  the 
objects  passed  to  them.  The  only  difference  is  that  one  method  would 
take  a  StingPatrol,  and  the  other  would  take  a  NectarCollector  that 
happens  to  have  the  methods  necessary  for  patrolling  the  hive.  And 
you  already  know  how  painful  it  is  to  maintain  two  identical  methods. 


Even  i-P  -tke  gueen  adds  sting  patrol  metkods 
to  a  NeitarColledtor  objefrt  ske  still  tant 
pass  it  to  ker  Pe-fendTkeHiveO  metkod 
betause  it  expetts  a  StingPatrol  rePerente 
Ske  tan't  just  set  a  StingPatrol  re-Perente 
e«\ual  to  a  NettarCollettor  objett-  A 


Luckily,  C#  gives  us  interfaces  to  handle  situations  like  that. 
Interfaces  let  you  deline  a  bunch  of  methods  that  a  class  must  have. 

An  interface  requires  that  a  class  has  certain  methods,  and  the  way 
that  it  does  that  is  that  it  makes  the  compiler  throw  errors  if  it 
doesn’t  find  all  the  methods  required  by  the  interface  in  every  class 
that  implements  it.  Those  methods  can  be  coded  directly  in  the  class, 
or  they  can  be  inherited  from  a  base  class.  The  interface  doesn’t  care 
how  the  methods  or  properties  get  there,  as  long  as  they’re  there 
when  the  code  is  compiled. 
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Ske  tould  add  a  setond  method  tailed 

AlternateDe-fendTheltiveO  that  'takes  a 

NettarCollettor  rePerente  instead,  but  tkat  would 
be  tumbersome  and  diPPitult  to  work  with-  ■T' 

Plus,  tke  De-PendTkettiveO  and  ' 

AltemateDe-PendTkeHiveO  metkods  would  be  identital 
extept  -for  tke  type  oP  tke  parameter.  I-P  ske  wanted 
to  teatk  tke  BabyBeeCare  or  Maintenante  objetts  to 
de-Pend  tke  hive,  she'd  need  to  keep  adding  new  metkods. 

What  a  messl 


interfaces  and  abstract  classes 


Use  the  interface  keyword  to  define  aw  interface 


Adding  an  interface  to  your  program  is  a  lot  like  adding  a  class, 
except  you  never  write  any  methods.  You  just  define  the  methods’ 
return  type  and  parameters,  but  instead  of  a  block  of  statements 
inside  curly  brackets  you  just  end  the  line  with  a  semicolon. 

Interfaces  do  not  store  data,  so  you  can’t  add  any  fields.  But  you  can 
add  definitions  for  properties.  The  reason  is  that  get  and  set  accessors  are 
just  methods,  and  interfaces  are  all  about  forcing  classes  to  have  certain 
methods  with  specific  names,  types  and  parameters.  So  if  you  want 
your  interface  to  require  a  field  with  a  certain  name  and  type,  just  use  a 
property  instead — it’ll  accomplish  the  same  thing. 


Iwterfade  names  start  with  I 

Whenever  Create  an  interface,  you  should  make 
its  name  start  with  an  U??erdase  I.  There  s  rule 
that  sa7s  70U  need  to  do  it,  but  it  makes  7our  Code 
a  lot  easier  to  understand-  You  dan  see  for  7ourselt 
Vust  hovi  muth  easier  that  tan  make  7our  life-  ^t 

.0  into  the  m  to  Wa"k  lme  mS'de  f "V 
and  1 ype  T-|«telliSense  shovis  -NTT  intertates. 


You  detlare  an  ■ 
interface  like  this: 

do»  i  have 

+ields„.  but  they  ca» 
have  Properties. 

Any  class  that  implements  - 
this  interfade  will  need  a 
SharpenStingerO  method  that 
takes  an  int  parameter. 

bt 

,_„4-her  dlass-  So  an 


public  interface  IStingPatrol 

int  AlertLevel  {  get;} 
int  StingerLength  {  get;  set;} 
bool  LookForEnemies ( ) ; 
int  SharpenStinger (int  Length), 


public  interface  INectarCollector 

{ 


Any  class  that 
'mplements  this 
method  must 
tave  all  of  these 
methods  and 
properties,  or  the 
program  won't 

dompile. 


another  UK.—  ■  r  are 

methods  in  an  ‘nfer^a 

automatitally  Y*w,t- 


void  FindFlowers () ; 
void  GatherNectar ( ) ; 

void  ReturnToHive  ( )  ;  „  the  tfde  for  the 

x/oudontwr^  r  u  wst  their 

,ts  it- 


met 
names- 


Since  this  takes  an 

IStingPatrol  reference,  you  ,  ,  -  p\emen- 

dan  pass  it  AKYobjedt  that  ^  ? 

implements  IStingPatrol. 

So  how  does  this  help  the  queen?  Now  she  can  make  one^single  method  that  takes  any 
object  that  knows  how  to  defend  the  hive: 


Everything  in  a 
public  interface 
is  automatically 
public,  because 


private  void  DefendTheHive (IStingPatrol  patroller) 

This  gives  the  queen  a  single  method  that  can  take  a  StingPatrol, 
NectarStinger,  and  any  other  bee  that  knows  how  to  defend  the  hive — it 
doesn’t  matter  which  class  she  passes  to  the  method.  As  long  as  it  implements 
IStingPatrol,  the  DefendTheHive  ( )  is  guaranteed  that  the  object  has  the 
methods  and  properties  it  needs  to  defend  the  hive. 


you’ll  use  it  to 
define  tbe  public 
methods  and 
properties  of 
any  class  that 
implements  it. 


you  are  here  ► 
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a  little  bit  nectarcollector  and  a  little  bit  stingpatrol 


Now  you  caw  create  aw  iwstawce  of 
NectarStinger  that  does  both  jobs 

You  use  the  colon  operator  to  declare  an  interface,  just  like  you  do  for 
inheritance.  It  works  like  this:  the  first  thing  after  the  colon  is  the  class 
it  inherits  from,  followed  by  a  list  of  interfaces  —  unless  it  doesn’t  inherit 
from  a  class,  in  which  case  it’s  just  a  list  of  interfaces  (in  no  particular 
order).  This  dlass  ihhcvrfcs  rrom  l/Vov-kev  3r\d 

You  iwplemeirl  an  inter-fade  with  a  dolon  implements  INedtav-Colledtov-  and 
operator,  just  like  you  inherit-  ^  (Stingpatrol.  ^ 

class  Nectar Stinger ^7  WorkerT'  INectarCollector , 

IStingPatrol  {  |< - you  t an  use 

Public  int  AlertLevel  {  than  one 

{  return  alertLevel ;  }  mter-fade  i-C  you 

separate  them 
with  dommas- 


pul 

tinner  } 


get 


The  NedtarStmger 
sets  the  loadking 
-field  for  the 
AlertLevel 
property  in  its 

Lookportnemiesf ) 

method- 


^very  method 
in  the  mterfade  ( 
has  a  method 
in  the  dlass. 
Otherwise  it 

wouldn't  dompile- 


public  int  StingerLength  { 


get 

set 

} 


return  StingerLength; 
StingerLength  =  value; 


} 


public  bool  LookForEnemies ()  { . . . } 
public  int  Sharpens tinger (int  Length) 


public  void  FindFlowers ( )  {. 
public  void  GatherNectar ()  { 
public  void  ReturnToHive ()  { 


■  } 
■  } 


The  bee  retradts  its 
when  there 

^e  no  enemies  around, 

oc  auit  _ _ _ ^  so  'the  backing  field 

Nedta'rColledtor  and  a  StingPatrol  worker  bee-  dhanges  its  value  over 


^Vhen  you  dreate  a  KedtarStinger  objedt,  it 
will  be  able  to  do  the  the  job  of  both  a 


When  you’ve  got  a  class  that  implements  an  interface,  it  acts  just  like 
any  other  class.  You  can  instantiate  it  with  new  and  use  its  methods: 

NectarStinger  bobTheBee  =  new  NectarStinger () ; 

bobTheBee . LookForEnemies () ; 

bobTheBee . FindFlowers ( )  ; 


_  tfieremre  no  _ 

Dumb  Questions 

O:  I  still  don’t  quite  get  how  interfaces  improve 
the  beehive  code.  You’ll  still  need  to  add  a 
NectarStinger  class,  and  it’ll  still  have  duplicate 
code. ..right? 

Interfaces  aren't  about  preventing  you  from 
duplicating  code.  They're  about  letting  you  use  one  class  in 
more  than  one  situation.  The  goal  is  to  create  one  worker 
bee  class  that  can  do  two  different  jobs.  You’ll  still  need 
to  create  classes  for  them— that’s  not  the  point.  The  point 
of  the  interfaces  is  that  now  you've  got  a  way  to  have  a 
class  that  does  any  number  of  jobs.  Let's  say  you  have 
a  PatrolTheHive()  method  that  takes  a  StingPatrol  object 
and  a  CollectNectar()  method  that  takes  a  NectarCollector 
object.  But  you  don't  want  StingPatrol  to  inherit  from 
NectarCollector  or  vice  versa— each  class  has  public 
methods  and  properties  that  the  other  one  shouldn't  have. 
Now  take  a  minute  and  try  to  think  of  a  way  to  create  one 
single  class  whose  instances  could  be  passed  to  both 
methods.  Seriously,  put  the  book  down,  take  a  minute  and 
try  to  think  up  a  way!  How  do  you  do  it? 

Interfaces  fix  that  problem.  Now  you  can  create  an 
IStingPatrol  reference— and  that  reference  can  point  to 
any  object  that  implements  IStingPatrol,  no  matter  what 
the  actual  class  is.  It  can  point  to  a  StingPatrol,  or  a 
NectarStinger,  or  even  a  totally  unrelated  object.  If  you've 
got  an  IStingPatrol  reference  pointing  to  an  object,  then  you 
know  you  can  use  all  of  the  methods  and  properties  that  are 
part  of  the  IStingPatrol  interface,  regardless  of  the  actual 
type  of  the  object. 

But  the  interface  is  only  part  of  the  solution.  You'll  still 
need  to  create  a  new  class  that  implements  the  interface, 
because  it  doesn't  actually  come  with  any  code.  Interfaces 
aren't  about  avoiding  the  creation  of  extra  classes  or 
avoiding  duplicate  code.  They're  about  making  one  class 
that  can  do  more  than  one  job  without  relying  on  inheritance, 
because  inheritance  brings  along  a  lot  of  extra  baggage— 
you'll  have  to  inherit  every  method,  property  and  field,  not 
just  the  ones  that  have  to  do  with  the  specific  job. 

Can  you  think  of  ways  that  you  could  still  avoid  duplicating 
code  while  using  an  interface?  You  could  create  a  separate 
class  called  Stinger  or  Proboscis  to  contain  the  code  that’s 
specific  to  stinging  or  collecting  nectar.  NectarStinger  and 
NectarCollector  could  both  create  a  private  instance  of 
Proboscis,  and  any  time  they  need  to  collect  nectar,  they'd 
call  its  methods  and  set  its  properties. 
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interfaces  and  abstract  classes 


Classes  that  implement  interfaces  have  to 
include  AIL  of  the  interface's  methods 


Implementing  an  interface  means  that  you  have  to  have  a  method  in  the  class 
for  each  and  every  property  and  method  that’s  declared  in  the  interface — if  it 
doesn’t  have  every  one  of  them,  it  won’t  compile.  If  a  class  implements  more 
than  one  interface,  then  it  needs  to  include  all  of  the  properties  and  methods  in 
each  of  the  interfaces  it  implements.  But  don’t  take  our  word  for  it...  J 


Al)^ 


o 


Create  a  new  application  and  add  a  new  class  file  called  IStingPatrol.es 

Instead  of  adding  a  class,  type  in  the  IStingPatrol  interface  on  the  previous  page. 


© 


Add  a  Bee  class  to  the  project 

Don’t  add  any  properties  or  methods  yet.  Just  have  it  implement  IStingPatrol: 
public  class  Bee  :  IStingPatrol  { 


Try  to  compile  the  program 

Select  “Rebuild”  from  the  Build  menu.  Uh-oh- 


-the  compiler  won’t  let  you  do  it: 


Error  List 


Q  4  Errors 


J\  0  Warnings 


(T)  0  Messages 


Description 


’HFCsharp.Chapter7.Bee'  does  not  implement  interface  member 
'HFCsharp .  Chapter7 .  IStingPatrol .  AlertLevel' 


'HFCsharp. Chapter7. Bee'  does  not  implement  interface  member 
'HFCsharp .  Chapter7 .  IStingPatrol .  StingerLength' 

'HFCsharp. Chapter7. Bee'  does  not  implement  interface  member 
'HFCsharp .  Chapter7 .  IStingPatrol .  LookForEnemies()' 

'HFCsharp. Chapter7. Bee'  does  not  implement  interface  member 
'HFCsharp .  Chapter7 .  IStingPatrol .  SharpenStinger(int)' 

i^  Error  List  ^  Find  Results  jjJ^Find  Symbol  Results 


You’ll  see  one  of  -these 
"does  not  implement” err  cm 
•  for  every  member  or 
IStingPatrol  that’s  not 
implemented  in  the  class. 
jThe  Compiler  really  wants 
^OU  *to  implement  every 
method  in  the  interface 


O 


Add  the  methods  and  properties  to  the  Bee  class 

Add  a  LookForEnemies  method  and  a  SharpenStinger  method — they  don’t  have  to 
do  anything,  they  just  need  to  compile.  Then  add  a  get  accessor  for  an  int  called  AlertLevel 
and  get  and  set  accessors  for  an  int  called  StingerLength.  Now  the  program  will  compile! 


you  are  here  ► 
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clowning  around 


fret  a  little  practice  using  interfaces 


Interlaces  are  really  easy  to  use,  hut  the  best  way  to  understand  is  to 
start  using  them.  So  create  a  new  Windows  Forms  Application  project, 
drag  a  button  onto  the  form,  and  get  started! 


Do  tliis! 


Here’s  the  TallGuy  class,  and  the  code  for  a  button  that  creates  it  using  an  object  initializer 
and  calls  its  TalkAbou t YoursellQ  method.  Nothing  new  here  we’ll  use  it  in  a  minute: 


public  class  TallGuy  { 
public  string  Name; 
public  int  Height; 

public  void  TalkAboutYourself ( )  { 

MessageBox. Show ("My  name  is  "  +  Name  +  "  and  I'm  " 
+  Height  +  "  inches  tall."); 

} 


private  void  buttonl_Click (object  sender,  EventArgs  e)  { 

TallGuy  tallGuy  =  new  TallGuy ()  {  Height  =  74,  Name  =  "Jimmy"  }; 
tallGuy. TalkAboutYourself ( ) ; 

} 


Let’s  create  an  IClown  interface  for  the  class. 


You  already  know  that  everything  inside  an  interface  has  to  be  public.  But  don’t  take  our 
word  lor  it.  Create  a  new  project  and  declare  an  interface  on  your  own,  like  this: 


public  interface  IClown 

Now  try  to  declare  a  private  method  inside  the  interface: 

private  void  Honk ( ) ; 

Select  Build»Build  Solution  in  the  IDF,.  You’ll  see  this  error: 


Q  1  The  modifier  'private1  is  not  valid  for  this  item 


V^u  don't  need  to 

"public"  the 
‘"Mace,  because 
Juic^afically  makes 
every  property 
method  public. 


Now  go  ahead  and  delete  the  private  access  modifier  the  error  w  ill  go  away  and 
your  program  will  compile  just  line. 


Before  you  go  on  to  the  next  page,  see  if  you  can  create  the  rest  of  the  IClown  interface,  and  modify  the 
TallGuy  class  to  implement  this  interface.  Add  your  interlace  to  your  project  just  like  you  add  a  class: 
right-click  on  the  project  in  the  Solution  Explorer  and  add  a  class  tile  called  IClown .  cs. 

Your  new  IClown  interface  should  have  a  void  method  called  Honk  that  doesn't  take  any  parameters, 
and  a  string  read-only  property  called  Funny  ThinglHave  that  has  a  get  accessor  but  no  set  accessor. 
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Here’s  the  interrace  did  you  get  it  right? 

public  interface  IClown 

< 

string  FunnyThinglHave  {  get;  } 
void  Honk ( ) ; 

} 


Were  s  an  example  ©f  an  interface 
■fctot  has  a  get  accessor  without  a 
set  accssor  Remember,  interfaces 
Can  t  Contain  f  ields,  but  when  you 
implement  this  read-only  property  m 
a  class,  it'll  look  like  a  field  to  other 
objects- 


Okay;  now  modify  the  TallGuy  class  so  that  it  implements  clown.  Remember, 
the  colon  operator  is  always  followed  by  the  base  class  to  inherit  from  (if  any'), 
and  then  a  list  of  interfaces  to  implement,  all  separated  by  commas.  Since 
there’s  no  base  class  and  only  one  interface  to  implement,  the  declaration  looks 

‘,ke  "1,S:  ^  Tf^  **  H^t  the  IClown  interface 

public  class  TallGuy  :  IClown  < - - 


Tlicn  make  sure  the  rest  of  the  class  is  the  same,  including  the  two  fields  and  the 
method.  Select  "Build  Solution"  from  the  Build  menu  in  the  IDE  to  compile 
and  build  the  program.  You'll  see  two  errors,  including  this  one: 


What  the  IDfc  «  telling 

you  is  that  when  you  said 
TallGuy  would  implement 
IClown,  you  promised  to 
add  all  of  the  properties 
and  methods  in  that 
interface  and  then  you 
broke  that  promise^ 


a 


'TallGuy'  does  not  implement  interface 
member  'IClown. Honk () ' 


The  errors  will  go  away  as  soon  as  you  add  all  of  the  methods  and  properties 
defined  in  the  interface.  So  go  ahead  and  implement  the  interface.  Add  a  read¬ 
only  string  property  called  FunnyThinglHave  with  a  get  accessor  that  always 
returns  die  siring  "big  shoes".  Then  add  a  HonkQ  method  that  pops  up  a 

•  i-L-u-  a  claw  that 

yjork  jtft  smC  * 

The  interface  says  that  you  need  a  public 
void  method  called  Honk,  but  it  doesn't  say 
what  that  method  needs  to  do.  It  can  do 
anything  at  all— no  matter  what  it  does,  the 
code  will  Compile  as  long  as  some  method  is 
there  with  the  right  signature 


message  box  that  says,  “Honk  honk!”. 
Here’s  what  it’ll  look  like: 

public  string  FunnyThinglHave 
get  {  return  "big  shoes"; 

} 


public  void  Honk()  { 

MessageBox. Show ("Honk  honk!") ; 

1 


Now  your  code  will  compile!  Update  your  button  so  that  the  object 
initializer  sets  the  FunnyThinglHave  property;  and  the  button  calls 
the  TallGuy  object’s  HonkQ  method. 


you  are  here  > 
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interfaces  don’t  make  objects 


You  can't  instantiate  an  interface, 
but  you  can  reference  an  interface 

Say  you  had  a  method  that  needed  an  object  that  could  perform 
the  FindFlowersO  method.  Any  object  that  implemented  the 
INectarCollector  interface  would  do.  It  could  be  a  Worker  object, 
or  a  Robot  object  or  a  Dog  object  as  long  as  it  implements  the 
INectarCollector  interface. 

That's  where  interface  references  come  in.  You  can  use 
one  to  refer  to  an  object  that  implements  the  interface  you  need 
and  you'll  always  be  sure  that  it  has  the  right  methods  for  your 
purpose — even  if  you  don’t  know  much  else  about  it. 


This  won’t  work... 

IStingPatrol  dennis  =  new  IStingPatrol ( ) ; 
Q  1  Cannot  create  an  instance  of  the  abstract  class  or  interface  } 

You  can’t  use  the  new  keyword  with  an  interface,  which  makes  sense — the 
methods  and  properties  don’t  have  any  implementation.  If  you  could 
create  an  object  from  an  interface,  how  would  it  know  how  to  behave? 


|f  you  try  to  t>* 
JLliatr  an  ir iterfaCe, 


So  what  happened? 

There’s  only  one  new  statement,  so  only  one  object  was  created.  The 
second  statement  created  a  reference  variable  c:ilied  george  that  can 
point  to  an  instance  of  any  class  that  implements  IStingPatrol. 


...but  this  will. 


Remember  bow  you 
could  pass  a  BLT  /s' 
reference  info  any 
class  that  expects  a 
Sandwich,  because  BLT 
inherits  -from  Sandwich? 
Well,  this  is  the  same 
thin^— you  Can  use  a 
Nectar  Stinger  in  any 
method  or  statement 
that  expects  an 
IStingPatrol 


NectarStinger  fred  =  new  NectarStinger ( ) 


IStingPatrol  george  =  fred; 


The  first  line  is  an  ordinary  new  statement,  creating  reference  called  Fred 
and  pointing  it  to  a  NectarStinger  object. 

The  second  line  is  where  things  start  to  get  interesting,  because  that  line 
of  eode  creates  a  new  reference  variable  using  IStingPatrol. 

That  line  may  look  a  little  odd  when  you  first  see  it.  But  look  at  this: 

NectarStinger  ginger  =  fred; 

You  know  what  this  third  statement  does  it  creates  a  new  NectarStinger 
reference  called  ginger  and  points  it  at  whatever  object  fred  is 
pointing  to.  The  george  statement  uses  IStingPatrol  the  same  way. 


fcven  though  this 
object  tan  do 
more,  when  yow 
use  an  interface 
reference  you  only 
have  access  to 

methods  m 
the  interface 


'Cf QrSX v'C'ft 
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Interface  references  work  just  like  object  references 


You  already  know  all  about  how  objects  live  on  the  heap. 
When  you  work  with  an  interface  reference,  it's  just  another 
way  to  refer  to  the  same  objects  you’ve  already  been  dealing 
with.  Look  it’s  easy! 


Create  a  couple  of  bees 

This  is  totally  familiar  stuff  by  now. 

StingPatrol  biff  =  new  StingPatrol  () ; 
NectarCollector  bertha  =  new  NectarCollector (); 


//79PatC°N 


Add  IStingPatrol  and  INectarCollector  references 

You  can  use  interface  references  just  like  you  use  any  oilier 
reference  type. 

C  IStingPatrol  defender  =  biff; 


An  interface  reference  will  keep  an  object  alive 

When  there  aren’t  any  references  pointing  to  an  object,  it 
disappears.  But  there’s  no  rule  that  says  those  references  all  have 
to  be  the  same  type!  An  interface  reference  is  just  as  good  as  an 
object  reference  when  it  comes  to  keeping  track  of  objects. 


biff  =  null; 


This  object  didn’t  disappear 
beCause  defender  is  still 
pointing  to  it- 


Assign  a  new  instance  to  an  interface  reference 

You  don’t  actually'  need  an  object  reference  you  can  create  a  new 
object  and  assign  it  straight  to  an  interface  reference  variable. 

INectarCollector  gatherer  =  new  Nectar Stinger () 


’9Pg\^y- - 


GATHERER 


4a 


‘^GrSV^ 


& 
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we're  expecting  a  big  inheritance 


You  can  find  out  if  a  class  implements  a 
certain  interface  with  "is" 

Sometimes  you  need  to  find  out  if  a  certain  class  implements  an  interface.  Suppose 
we  have  all  our  worker  bees  in  an  array,  called  Bees.  We  can  make  the  array  hold 
the  type  Worker,  since  all  worker  bees  will  be  Worker  classes,  or  subclasses  of  that 
type. 

But  which  of  the  worker  bees  can  collect  nectar?  In  other  words,  we  want  to  know 
if  the  class  implements  the  INectarCol  lector  interface.  We  can  use  the  is 
keyword  to  find  out  exactly  that. 


All  ihe  workers  are  in  a,  array  of  Workers.  We'll 
to  sort  out  which  type  of  worker  each  bee  is. 


U.  » 

us  c  IS 


c£  Worker  b«s  '“ho  a,re 

Worker  []  Bees  =  new  Worker  [3];  Were  got  ‘T  a  nectar  toilette 

all  cmo\t  p  i  arraVi  and ,s 

Bees  [  0 ]  =  new  NectarCollector  ( )  ;  s©  well  loop  though  the^  ^7  ^ 

Bee s  [  1  ]  =  new  S  tingPa trol  ( )  ;  to  do  the  job 

Bees  [2]  =  new  NectarStinger ( ) ; 
for  (int  i  =  0;  i  <  Bees. Length;  i++) 

if  (Bees[i]  (is  /^NectarCollector)  ^erator 

{ 


«  works  like  an 

(**>  tor  mterka« 


Th.s  is  like  saying,  if  this  bee  implements  the 
(NectarCollector  interface  do  this 

kT 

Bees [i] .DoThisJob ("Nectar  Collector",  3); 

>  f 

Collector ,  we  tan  Wp  0 

Collect.^  nettar 


If  you  have  some  other  class  that  doesn’t  inherit  from  Worker  but  does  implement  the 
INectarCollector  interface,  then  it’ll  be  able  to  do  the  job,  too!  But  since  it  doesn't  inherit 
from  Worker,  you  can’t  get  it  into  an  array  with  other  bees.  Can  you  think  of  a  way  to 
get  around  the  problem  and  create  an  array  with  both  bees  and  this  new  class? 
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Interfaces  can  inherit  from  other  interfaces 

When  one  class  inherits  from  another,  it  gets  all  of  the  methods  and 
properties  from  the  base  class.  Interface  inheritance  is  even  simpler. 

Since  there’s  no  actual  method  body  in  any  interface,  you  don’t  have 
to  worry  about  calling  base  constructors  or  methods.  The  inherited 
interfaces  simply  accumulate  all  of  the  mediods  and  properties  from 
the  interfaces  they  inherit  from. 


When  we  draw  an 
interface  on  a  class 
diagram,  we’ll  show 
inheritance  using 
dashed  lines. 


public  interface  IWorker 

{ 

} 


string  Job  {  get; 
int  Left  {  get;  } 

void  DoThis Job (string  Job,  int  Shifts) 
void  WorkOneShif t ( ) 


I 


We’ve  Created  a  new 
IWorker  interface  that 
the  other  interfaces 
inherit  from 


(interface) 

IWorker 


Job 

ShiftsLeft 


DoThis  Job() 
WofkOneShrftO 


<1 


Any  class  that  Implements  an  interface  that  inherits  from 
IWorker  must  implement  its  methods  and  properties 

When  a  class  implements  an  interface,  it  has  to  include  every  property  and 
method  in  that  interface.  And  if  that  interface  inherits  from  another  one,  then  all 
of  those  properties  and  methods  need  to  he  implemented,  too. 


(interface) 

(interface) 

IStingPatrol 

INectarCollector 

StingerLength 

Nectar 

EnemyAlert 

SharpenStinger() 

FindFlowere() 

LookForEnemies() 

GatherNectar() 

Stingf) 

RetumToHiveO 

public  interface  IStingPatrol  :  IWorker 

{ 

int  AlertLevel  {  get; } 
int  StingerLength  {  get;  set;} 
bool  LookForEnemies () ; 
int  Sharpens tinger (int  Length) 

1  \ 

*  a*,  tvt  <■*■•*”** 

„p\ement 


-bet  the  methods  of  the 
IWorker  interface  this  interface 
inherits  -from,  too. 


Job 

ShiftsLeft 


Here's  the  same  IStingPatrol 
interface,  bet  now  it  inherits  froi 
the  IWsrker  interface  It  looks 
like  a  tiny  change,  bet  it  makes  a 
he$e  difference  in  any  class  that 
implements  IStingPatrol 


(interface) 

IWorker 


DoThisJob() 

WorkOneShrft() 


you  are  here  ► 
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lea  hascheezburger 


The  RoboPee  4000  can  do  a  worker  bee's  job 
without  using  valuable  honey 


Let's  create  a  new  bee,  a  RoboBee  4000,  that  runs  on  gas.  We  can 
have  it  inherit  from  the  [Worker  interface,  though,  so  it  can  do 
everything  a  normal  worker  bee  can. 


Tte  is 

tUss.so^tsM"""' 
on  gasoline 


public  class  Robot 

{ 

public  void  ConsumeGas ( ) 

} 


RoboBee 


ShiftsToWork 

ShiftsWorked 

ShiftsLeft 

Job 


OoThisJobO 


public  class  RoboBee  :  Robot,  IWorker 

{ 


Ihe  Kobo Bee  das$ 
mberiLs  TVom  Robot  and 
'"'Plements  /Worker.  Thai 
*«eans  ,i‘s  a  robot  but  can 
do  the  job  of  a  worker 
bee.  Perfect 


The  RoboBee  ^ss 

)B,yle»»ents  all  *>»« 

methods  fro-,  the 

IWorker  interface- 


private  int  shiftsToWork; 
private  int  shiftsWorked; 
public  int  ShiftsLeft 

{get  {return  ShiftsToWork  -  ShiftsLeft;}} 
private  string  job; 
public  string  Job; {get {return  job;}} 

public  bool  DoThis Job (string  Job,  int  ShiftsToWork} { 

|(  RoWB«  M»'t  ■»  «-<  twr  ■> 

Interface,  the  tode  wouldnt  Co^yile- 


•  } 


Remember,  for  other  classes  in  the  application,  there’s  no 
functional  difference  between  a  RoboBee  and  a  normal  worker 
bee.  They  both  implement  the  IWorker  interface,  so  both  act  like 
worker  bees  as  far  as  the  rest  of  the  program  is  concerned. 

But,  you  could  distringuish  between  the  types  by  using  is: 


if  (workerBee  is  Robot)  { 
//  now  we  know  workerBee 
//  is  a  Robot  object 

} 


We  tan  see  what  tlass 
or  interface  workerBee 
,yle*nents  or  subtlasses 


with  "is  ” 


Any  class  can  implement 
ANY  interface  as  long 
as  it  keeps  tke  promise 
of  implementing  tke 
interface’s  metkods  anci 
properties. 
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is  tells  you  what  an  object  implements, 
as  tells  the  compiler  how  to  treat  your  object 


Sometimes  you  need  lo  cull  a  method  that  an  object  gets  from  an  interface  it 
implements.  But  what  if  you  don’t  know  if  that  object  is  the  right  type?  You 
use  is  to  find  that  out.  Then,  you  can  use  as  to  treat  that  object  which 
you  now  know  is  the  right  type — as  hat  ing  the  method  you  need  to  call. 

IWorker[]  Bees  =  new  IWorker [3]; 

Bees [0]  =  new  NectarStinger ( ) ; 

Bees[l]  =  new  RoboBee ( ) ; 

Bees [2]  =  new  Worker (); 

VVeVe  looping  ■through  c^ch  bee  ^  _ _ 

for  (int  i  =  0;  i  <  Bees. Length;  i++) 
if  (Bees[i]  is  INectarCollector) 


WettUColleeU. 


ones 

like 


{ 


•■•dhd  {j o 

see  if  i-t  implements 
I  MeciarCol  I  ector. 


INectarCollector  thisCollector ; 


iVe  can't  call 

INectarCollector  methods 
on  the  bees.  They're 
o-f  type  I  Worker,  and 
don  t  know  about 
INectarCollector  methods 


thisCollector  =  workers [i] 


INectarCollector ; 


thisCollector . EmptyNec tar Bucket ( ) ; 

f 

NOW  we  can  call  INectarCollector  methods. 


r  t,Jharpen  your  pencil 


itatior 


an 

,mplemen 


IWorker []  Bees  =  new  IWorker[8], 
Bees[0]  =  new  NectarStinger () ; 
Beesfl]  =  new  RoboBeeO; 

Bees  [2]  =  new  Worker (); 

Bees [3]  =  Bees[0]  as  IWorker; 
Bees [4]  =  IStingPatrol ; 

Bees [5]  =  null; 

Bees  [  6 ]  =  Bees [ 2 ] ; 

Bees [7]  =  new  INectarCollector ( ! 


Take  a  look  at  the  array  on  the  left.  For  each  of  these  statements, 
write  down  which  values  of  i  would  make  it  evaluate  to  true. 
Also,  two  of  them  won't  compile — cross  those  lines  out. 

1. (Bees[i]  is  INectarCollector) 


2.  (Bees  [i] 

is  IStingPatrol) 

3.  (Bees  [i  ] 

is  IWorker) 

you  are  here  ► 
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it  looks  like  one  thing,  but  it's  really  another! 


A  CoffeeMaker  is  also  an  Appliance 

If  you’re  trying  to  figure  out  how  to  rut  down  your  energy  hill  eacli  month,  you 
don’t  really  care  what  eacli  of  your  appliances  does.  You  only  really  care  that  they 
consume  power.  So  if  you  were  writing  a  program  to  monitor  your  electricity 
consumption,  you’d  probably  just  write  an  Appliance  class.  But  if  you  needed  to 
be  able  to  distinguish  a  coffee  maker  from  an  oven,  you'd  have  to  build  a  class 
hierarchy.  So  you'd  add  the  methods  and  properties  that  are  specific  to  a  coflee 
maker  or  oven  to  some  CoffeeMaker  and  Oven  classes,  and  they’d  inherit  from  an 
Appliance  class  that  has  their  common  methods  and  properties.. 


Appliance 

Pluggedln 

Color 


IConsumePowerji 


public  void  MonitorPower (Appliance  appliance)  { 

//  code  to  add  data  to  a  household  Here’s  a  method 
//  power  consumption  database  in  -the  program  to 

monitor  the  power 

This  dode  would  appear  later  on  in  the  Consumption  lor  a 

program  to  monitor  the  Coffee  maker’s  '  house 

power  Consumption 


‘A 


CoffeeMaker 

Oven 

CoffeeLefl 

Capacity 

FillWithWater() 

Preheat!) 

MakeCoffeef) 

HeatUpO 

Reheat!) 

CoffeeMaker  misterCoffee  =  new  Cof f eeMaker ( ) ; 
MonitorPower (misterCof fee) ; 


Sharpen  your  pencil 
^  v  Solution 


Even  though  the  /VlonitorPowerO  method 
,  ^kes  a  reference  to  an  Appliance  object,  ‘ 
you  can  pass  it  the  misterCoffee  reference 
because  CoffeeMaker  is  a  subclass  of 
Appliance 


You  already  saw  this 
in  the  last  chapter, 
when  you  saw  how 
you  Could  pass  a 
BLT  reference  to 
a  method  that 
expected  a  Sandwich 


Take  a  look  at  the  array  on  the  left.  For  each  of  these  statements, 
write  down  which  values  of  i  would  make  it  evaluate  to  true. 
Also,  two  of  them  won't  compile — cross  them  out. 


IWorker [ ]  Bees  =  new  IWorker[8];  l.(Bees[i]  is  INectarCollector ) 

Bees[0]  =  new  NectarStinger ( ) ;  <T~)  _ 

Bees[l]  =  new  RoboBeef);  NectarStingerO . . . 

Bees  [2]  =  new  Worker  ();  2-  (Bees[i]  is  IStingPatrol) 

Bees  [3]  =  Bees[0]  as  IWorker;  ,  £  ° 


ngratrol  ^ 
r+ace 


Bees  [5]  =  null;  AH  of  these  objects  inherit 

Bees  [  6  ]  =  Bees  [  0  ]  ;  from  base  class  l/Vorker. 


O,  h 

(Bees[i]  is  IWorker) 

0,1,  2.,  3,  and  h 
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Upcasting  works  with  both  objects  and  interfaces 

When  you  substitute  a  subclass  for  a  base  class  like  substituting  a  coffee  maker  for  an 
appliance  or  a  BLT  for  a  sandwich — it’s  called  upcasting.  It's  a  really  powerful  tool 
that  you  get  when  you  build  class  hierarchies.  The  only  drawback  to  upcasting  is  that 
you  can  only  use  the  properties  and  methods  of  the  base  class.  In  other  words,  when  you 
treat  a  coffee  maker  like  an  appliance,  you  can’t  tell  it  to  make  coffee  or  fill  it  with  water. 
But  you  ran  tell  whether  or  not  it’s  plugged  in.  since  that’s  something  you  can  do  with 
any  appliance  (which  is  why  the  Pluggedln  property  is  part  of  the  Appliance  class). 


Let’s  create  some  objects 

We  can  create  a  CoffeeMaker  and  Oven  class  as  usual: 

CoffeeMaker  raisterCof fee  =  new  CoffeeMaker () ; 
Oven  oldToasty  =  new  Oven(); 


~~3  We'll  start  by  instantiating 
^  jn  Oven  object  and  a 
_ j  CoffeeMaker  object  as  usual 


What  if  we  want  to  create  an  array  of  appliances? 

You  can’t  put  a  CoffeeMaker  in  an  Oven[  ]  array,  and  you  can’t  put  an  Oven  in  a 
Coffee. Makcr[  ]  array.  But  you  can  put  both  of  them  in  an  Appliancc[]  array: 


ippliancetl  kitchenware  =  new  Appliance [2] ;  .  „ 

v/^can  use  u?castmg  to  create  an 

:itchenWare  [0]  =  misterCof  fee;  r _ t. that  tan  nold 

litchenWare fll  =  oldToastv; 


But  you  can't  treat  an  appliance  like  an  oven 

W  hen  you’ve  got  an  Appliance  reference,  you  can  only  access  the  methods  and  properties 
that  have  to  do  with  appliances.  You  can’t  use  the  coffee  maker  methods  and  properties 
through  the  Appliance  reference  even  if  you  know  it’s  really  a  CoffeeMaker.  So  these 
statements  will  work  just  fine,  because  they  treat  a  CoffeeMaker  object  like  an  Appliance: 

Appliance  powerConsumer  =  new  CoffeeMaker!); 

powerConsumer .ConsumePower () ;  ^me  Compile  because 

powerConsumer  is  an  Appliance 

But  as  soon  as  you  try  to  use  it  like  a  Coffee  Maker: 
powerConsumer .MakeCof fee () ; 


reference,  so  if  can  only  be  used 
io  do  Appliance  things 


your  code  won’t  compile,  and  the  IDE  will  displays  an  error: 


o 


'Appliance'  does  not  contain  a 
definition  for  'MakeCoffee' 


powerConsumer 
is  an  Appliance 
reference 
pointing  to  a 

CoffeeMaker 
object 


0/f/ee/\AaV^ 


because  once  you  upcast  from  a  subclass  to  a  base  class,  then  you  can  only  access  the 
methods  and  properties  that  match  the  reference  that  you’re  using  to  access  llie  object. 
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upcasting  is  easy  downcasting  is  risky 


Powncastiwg  lets  you  turn  your  appliance 
back  into  a  coffee  maker 


Upcasting  is  a  great  tool,  because  it  lets  you  use  a  coffee  maker  or  an  oven 
anywhere  you  just  need  an  appliance.  But  it's  got  a  big  drawback  if  you’re  using 
an  Appliance  reference  that  points  to  a  CoffeeMaker  object,  you  can  only  use  the 
methods  and  properties  that  belong  to  Appliance.  .And  that’s  where  downcasting 
comes  in:  that’s  how  you  take  your  previously  upcast  reference  and  change 
it  back.  You  can  figure  out  if  your  Appliance  is  really  a  CoffeeMaker  using  the 
is  keyword.  And  once  you  know  that,  you  can  convert  the  Appliance  back  to  a 
CoffeeMaker  using  the  as  keyword. 

We'll  start  with  the  coffee  maker  we  already  upcast 

Here’s  the  code  that  we  used: 

Appliance  powerConsumer  =  new  CoffeeMaker!); 
powerConsumer . Consume Power ( ) ; 


But  what  if  we  want  to  turn  the  Appliance  back  into  a  CoffeeMaker? 

The  first  step  in  downcasting  is  using  the  is  keyword  to  check  if  it’s  even  an  option. 


Here’s  our  Appliance 
ref erende  that  points 
to  a  CoffeeMaker 
ob  ject  -from  the  last 

w  \ 


if  (powerConsumer  is  CoffeeMaker) 
//  then  we  can  downcast! 


Now  that  we  know  it's  a  CoffeeMaker,  let’s  use  it  like  one 

The  is  keyword  is  the  first  step.  Once  you  know  that  you’ve  got  an  Appliance 
reference  that’s  pointing  to  a  CoffeeMaker  object,  you  can  use  as  to  downcast  it. 

And  that  lets  you  use  the  CoffeeMaker  class’s  methods  and  properties.  And  since 
CoffeeMaker  inherits  from  Appliance,  it  still  has  its  Appliance  methods  and  properties. 

if  (powerConsumer  is  CoffeeMaker)  < 

CoffeeMaker  javaJoe  =  powerConsumer  as  CoffeeMaker; 
javaJoe.MakeCof fee () ; 

1 


The  java  Joe  reference 
points  to  the  same 
CoffeeMaker  object 
as  powerConsumer.  But 
it’s  a  CoffeeMaker 
reference,  so  it  dan 
call  the  MakeCoffeeO 

method  ^ 


When  downcasting  fails,  as  returns  null 


So  what  happens  if  you  try  to  use  as  to  convert  an  Own  object  into  a 
CoffeeMaker?  It  returns  null — and  if  you  try  to  use  it,  .NET  will  cause  your 


program  to  break. 

if  (powerConsumer  is  Cof feeMake 

Oven  foodWarmer  =  powerConsumer  as  Oven; 
f oodWarmer . Preheat ( ) ; _ 


Uh-oh— these 
don’t  m  atcM 


powerConsumer  is  SOT  an  Oven  object  So  when 
you  try  to  downcast  it  with  "as",  the  foodWarmer 
reference  ends  up  set  to  null  And  when  you  try 
to  use  a  null  reference,  this  hap 


> 


NullReferenceException  was  unhandled 


x 


I 
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interfaces  and  abstract  classes 


Upcasting  and  downcasting  work  with  interfaces,  too 

You  already  know  that  is  and  as  work  with  interlaces.  Well,  so  do  all  of  the 
upcasting  and  downcasting  tricks.  Let's  add  an  ICooksFood  interface  for  any 
class  that  can  heat  up  food.  And  we’ll  add  a  Microwave  class — both  Microwave 
and  Oven  implement  the  ICooksFood  interface.  Now  there  are  three  different 
ways  that  you  can  access  an  Oven  object.  And  the  IDE’s  IntelliSense  can  help 
you  figure  out  exactly  what  you  can  and  can't  do  with  each  of  them: 


(interface) 

ICooksFood 


Capacity 


Oven  misterToasty  =  new  Oven(); 


misterToasty . 

■m 


Capacity 


As  soon  as  you' 
■type  the  dot, 
the  IntelliSense 
window  will  fop 
up  with  3  list 
of-  all  of-  the 
members  you  can 
use 


5*  Color 

♦  ConsumePower 

♦  Equals 

♦  GetJHashCode 

♦  GetType 

♦  Heatup 
Pluggedln 

♦  Preheat 

♦  Reheat 


nt  Oven.Capacity 


HeatUpi) 

Reheatf) 


Any  class  that 

implements 
.ICooksFood 
1  is  an  appliance 
I  that  can  heat 

uP  food 


misterToasty  is  an  Oven  reference 
pointing  to  an  Oven  object,  so 
it  can  access  all  of  the  methods 
and  properties  but  it's  the 
least  general  type,  so  you  can 
only  point  it  at  Oven  objects. 


ICooksFood  cooker; 


Oven 

- • - - 

Microwave 

Capacity 

Capacity 

Preheat() 

HeatUp() 

HeatUpf) 

Reheat() 

Reheat() 

MakePopcorn() 

if  (misterToasty  is  ICooksFood) 

cooker  =  misterToasty  as  ICooksFood; 
cooker 

31 _ 

♦  Equals 

♦  GetHashCode 

♦  GetType 
♦Heatup 

♦  Reheat 

♦  ToStrmg 


nt  ICooksFood.Capaaty 

Cooker  is  an  ICooksFood  reference 
pointing  to  that  same  Oven  object  It 
can  only  access  ICooksFood  members 
But  it  can  also  point  to  a  MiCrowave 
object. 


Appliance  powerConsumer; 
if  (misterToasty  is  Appliance) 

powerConsumer  =  misterToasty; 
powerConsumer . 


powerConsumer  is  an 
Appliance  reference  It 
only  lets  you  get  to  the 
public  fields,  methods  and 
properties  in  Appliance 
You  Can  also  point  it  at 
a  CoffeeMaker  object  if 
you  want- 


♦  ConsumePower 

♦  Equals 

♦  GetHashCode 

♦  GetType 
^  Pluggedln 

1  ToStrrig 


Color  Appkance.  Color 


Three  different 
references  that 
point  to  the 
same  object  can 
access  different 
methods  and 
properties, 
depending  on 
the  reference’s 
type. 
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no  dumb  questions 


there  i  ore  no 

Dumb  Questions 


;  So  back  up— you  told  me  that  I 
can  always  upcast  but  I  can’t  always 
downcast.  Why? 

A* 

Because  the  compiler  can  warn  you 
if  your  upcast  is  wrong  The  only  time  an 
upcast  won’t  work  is  if  you're  trying  to  set  an 
object  equal  to  a  class  that  it  doesn’t  inherit 
from  or  an  interface  that  it  doesn’t  implement. 
And  the  compiler  can  figure  out  immediately 
that  you  didn’t  upcast  properly,  and  will  give 
you  an  error. 

On  the  other  hand,  the  compiler  doesn't 
know  how  to  check  if  you're  downcasting 
from  an  object  or  interface  reference  to  a 
reference  that's  not  valid.  That's  because  it's 
perfectly  legal  to  put  any  class  or  interface 
name  on  the  right-hand  side  of  the  as 
keyword.  If  the  downcast  is  illegal,  then  the 
as  statement  will  just  return  null.  And 
it’s  a  good  thing  that  the  compiler  doesn  t 
stop  you  from  doing  that,  because  there  are 
plenty  of  times  when  you'd  want  to  do  that. 

;  Someone  told  me  that  an  interface 
is  like  a  contract,  but  I  don’t  really  get 
why.  What  does  that  mean? 

,/\l  Yes,  we’ve  heard  that  too— a  lot 
of  people  like  to  say  that  an  interface  is 
like  a  contract.  (That’s  a  really  common 
question  on  job  interviews  )  And  it's  true,  to 
some  extent.  When  you  make  your  class 
implement  an  interface,  you're  telling  the 
compiler  that  you  promise  to  put  certain 
methods  into  it.  The  compiler  will  hold  you  to 
that  promise. 

But  we  think  that  it’s  easier  to  remember 
how  interfaces  work  if  you  think  of  an 
interface  as  a  kind  of  checklist.  The  compiler 
runs  through  the  checklist  to  make  sure  that 
you  actually  put  all  of  the  methods  from  the 
interface  into  your  class.  If  you  didn't,  it'll 
bomb  out  and  not  let  you  compile. 


ry 

Vj-  What  if  I  want  to  put  a  method  body 
into  my  interface?  Is  that  okay? 

No,  the  compiler  won't  let  you  do 
that.  An  interface  isn't  allowed  to  have  any 
statements  in  it  at  all.  Even  though  you  use 
the  colon  operator  to  implement  an  interface, 
it’s  not  the  same  thing  as  inheriting  from  a 
class.  Implementing  an  interface  doesn't 
add  any  behavior  to  your  class  at  all,  or 
make  any  changes  to  it.  All  it  does  is  tell  the 
compiler  to  make  sure  that  your  class  has 
all  of  the  methods  that  the  interface  says  it 
should  have. 

o 

Then  why  would  I  want  to  use  an 
interface?  It  seems  like  it’s  just  adding 
restrictions,  without  actually  changing 
my  class  at  all. 

Because  when  your  class  implements 
an  interface,  then  an  interface  reference  can 
point  to  any  instance  of  that  class.  And  that's 
really  useful  to  you— it  lets  you  create  one 
reference  type  that  can  work  a  whole  bunch 
of  different  kinds  of  objects. 

Here's  a  quick  example.  A  horse,  an  ox,  a 
mule,  and  a  steer  can  all  pull  a  cart.  But 
in  our  zoo  simulator,  Horse,  Ox,  Mule,  and 
Steer  would  all  be  different  classes.  Let's  say 
you  had  a  cart-pulling  ride  in  your  zoo,  and 
you  wanted  to  create  an  array  of  any  animal 
that  could  pull  carts  around.  Uh-oh— you 
can't  just  create  an  array  that  will  hold  all 
of  those.  If  they  all  inherited  from  the  same 
base  class,  then  you  could  create  an  array 
of  those.  But  it  turns  out  that  they  don’t.  So 
what’ll  you  do? 

That's  where  interfaces  come  in  handy,  You 
can  create  an  IPuller  interface  that  has 
methods  for  pulling  carts  around.  Now  you 
could  declare  your  array  like  this: 

IPuller []  pullerArray; 


Now  you  can  put  a  reference  to  any 
animal  you  want  in  that  array,  as  long  as  it 
implements  the  IPuller  interface. 

o 

^ ’j  is  there  an  easier  way  to  implement 
interfaces?  It's  a  lot  of  typing! 

Why  yes,  there  is!  The  IDE  gives  you 
a  very  powerful  shortcut  that  automatically 
implements  an  interface  for  you.  Just  start 
typing  your  class: 

public  class 

Microwave  :  ICooksFood 

{  ) 

Click  on  ICooksFood— you’ll  see  a  small  bar 
appear  underneath  the  T.  Hover  over  it  and 
you'll  see  an  icon  appear  underneath  it: 

[interface  ICooksFood 

ICooksFood 

HI 


Click  on  icon  and  choose  “Implement 
Interface  ICooksFood from  the  menu.  It'll 
automatically  add  any  members  that  you 
haven't  implemented  yet.  Each  one  has  a 
single  throws  statement  in  it— they'll 
cause  your  program  to  halt,  as  a  reminder 
in  case  you  forget  to  implement  one  of  them 
(You’ll  team  about  throws  in  chapter  10.) 

Aii  interlace  is  like 
a  ckecklist  tkat  tke 
compiler  runs  through 
to  make  sure  your 
class  implemented  a 
certain  set  ol  methods. 
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Start 


Extend  the  ICIown  interface  and  use  classes  that  implement  it. 


Start  with  the  I  Cl  own  interface  from  the  last  "Do  fjjtsT'  on  page  258 

public  interface  ICIown  { 

string  FunnyThinglHave  {  get;  } 
void  Honk ( ) ; 


interfaces  and  abstract  classes 


ICIown 

(interface) 

FunnyThinglHave 


Extend  ICIown  by  creating  a  new  interface,  IScaryClown,  that  FunnyThinglHave 

inherits  from  ICIown.  It  should  have  an  additional  string 

property  called  ScaryThinglHave  with  a  get  accessor  but  no  set  _ 

accessor,  and  a  void  method  called  ScareLitt  leChildren  ( ) .  Honk0 

Create  these  classes: 

*  A  funny  clown  class  called  FunnyFunny  that  uses  a  private  string 

variable  to  store  a  funny  thing,  and  use  a  constructor  that  takes  \ 

a  parameter  called  f  unnyThinglHave  and  uses  it  to  set  the  Scai 

private  field.  The  Honk  ( )  method  should  say;  “Honk  honk!  I  have  ScafyTh 

a  ”  followed  by  the  funny  thing  it  has.  The  FunnyThinglHave  set 

accessor  should  return  the  same  thing.  _ 

ScareLit 

*  A  scary  clown  class  called  ScaryScary  that  uses  a  private 
variable  to  store  an  integer  that  was  passed  to  it  by  its  constructor 
in  a  parameter  called  numberOfScaryThings.  The 
ScaryThinglHave  get  accessor  should  return  a  string  consisting 
of  die  number  from  the  constructor  followed  by  “spiders”.  The 
Honk  ( )  pops  up  a  message  box  that  says,  “Boo!  Gotcha!” 

Here’s  code  for  a  button — but  it’s  not  working.  Can  you  figure  out  how  to  fix  it? 

private  void  buttonl_Click (object  sender,  EventArgs  e)  < 

ScaryScary  fingersTheClown  =  new  ScaryScary ("big  shoes",  14); 
FunnyFunny  someFunnyCiown  =  fingersTheClown; 

IScaryClown  someOtherScaryclown  =  someFunnyCiown; 
someOtherScaryclown.Honk() ; 


IScaryClown 

(interface) 

ScaryThinglHave 

Scare  LittleChildem() 


I  ScaryThinglHave 


I  ScareLittleChildernQ 


f  ibers  the  Clown  is  ^7 


You  better  get  this 
one  right...  or  else! 
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no  no!  nooo!  noo!  no  more  scary  clowns! 


S°Lwiioi 


Extend  the  ICIown  interface  and  use  classes  that  implement  it, 


)OLyt»OH 

public  interface  ICIown  { 

string  FunnyThinglHave  {  get;  } 
void  Honk ( ) ; 


public  interface  IScaryClown  :  ICIown  { 
string  ScaryThinglHave  {  get;  > 
void  ScareLittleChildren ( ) ; 

> 

public  class  FunnyFunny  :  ICIown  ( 


The  HonkO 
method  just  uses 
this  set  accessor 


public  FunnyFunny  (string  funnyThinglHave)  (  to  display  its 

this .  f unnyThinglHave  <=  funnyThinglHave;  message— no  heed  You  Could  have 

I  _ —  to  have  the  same  implemented  the 

private  string  funnyThinglHave;  Code  ICIown  method  and 

public  string  FunnyThinglHave  {  property  a^ain,  but 

get  (  return  "Honk  honk!  I  have  "  +  funnyThinglHave;  )  wj,y  h0t  just  inherit 
I  &*om  FunnyFunny? 

public  void  Honk()  {  | 

MessageBox.Show (this. FunnyThinglHave) ;  X 

'  — .Sinde  SdarySdary  is  a  subclass  of  FunnyFunny  and  FunnyFunny 

f  implements  ICIown,  SdarySdary  implements  ICIown  too 


public  class  ScaryScary  : NgiinnvFunnv2  IScaryClown  ( 

public  ScaryScary (string  funnyThinglHave,  int  numberOfScaryThings) 
:  base (funnyThinglHave)  ( 

this. numberOfScaryThings  =  numberOfScaryThings; 


private  int  numberOfScaryThings; 
public  string  ScaryThinglHave  ( 

get  (  return  "I  have  "  +  numberOfScaryThings  + 

j  you  dan  set  a  F 

public  void  ScareLittleChildren  ()  { 

j  any  (SdaryClow* 


fScaryThings  +  *  spiders";  ) 

r  a  reference  e.ual 

to  a  ScaryScary  object  because  ScaryScary 

fy  IS^yC,°^  reference  to  just  any  clown, 
because  you  don  {  know  if  tha^  dlowJ.s  scary. 

,  EventAxi|s^<e)hef<1  ^  ^he  as  keyword. 


private  void  buttonl_Click (object  sender,  EventArgs' e)  {  me  as  keywo 

ScaryScary  f ingersTheClown  =  new  ScaryScary ("big  shoes",  14);  J 

FunnyFunny  someFunnyClown  =  f ingersTheClown;  l/ 

IScaryClown  someOtherScaryclown  =  someFunnyClown  as  ScaryScary; 
someOtherScaryclown . Honk ( ) ; 
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There's  wore  than  just  public  and  private 


You  already  know  how  important  the  private  keyword  is,  how  you  use  it,  and 
how  it’s  different  from  public.  C#  has  a  name  for  them:  they’re  called  access 
modifiers.  The  name  makes  sense,  because  when  you  change  an  access  / 
modifier  on  a  property,  field,  or  method  of  a  class—  its  members — or  the  f, 
entire  class,  you  change  the  way  other  classes  can  access  it.  There  are  a  few  more 
access  modifiers  that  you’ll  use,  but  we’ll  start  witht  lie  ones  you  know: 


call  a  class's  methods, 

•fields  and  properties  its 
members  Any  member  ear,  be 
marked  with  the  public  or 
private  access  modi-Pier. 


public  means  that  anyone  can  access  it 

When  you  mark  a  class  or  class  member  public,  you’re  telling  C#  that  any  member  of 
other  class  can  access  it.  It’s  the  least  restrictive  access  modifier.  And  you’ve  already  seen  how 
it  can  get  you  in  trouble — only  mark  class  members  public  if  you  have  a  reason.  That’s  how 
you  make  sure  your  clases  arc  well-encapsulated. 


private  means  that  only  other  members  can  access  it 

When  you  mark  a  class  member  private,  then  it  can  only  be  accessed  from  other  members 
inside  that  class  or  other  instances  of  that  class..  And  when  you  mark  a  class  private, 
then  it  can  only  be  used  by  other  classes  inside  its  namespace  -unless  that  class  lives  inside 
another  class,  in  which  case  it’s  only  available  to  instances  of  its  container  class. 


protected  means  public  to  subclasses,  private  to  everyone  else 

You’ve  already  seen  how  a  subclass  can’t  access  the  private  fields  in  its  base  class  it  has 
to  use  the  base  keyword  to  get  to  the  public  members  of  the  base  object.  Wouldn't  it 
be  convenient  if  the  subclass  could  access  those  private  fields?  That’s  why  you  hav  e  the 
protected  access  modifier.  Any  class  member  marked  protected  can  be  accessed  by 
any  other  member  of  its  class,  and  any  member  of  a  subclass  of  its  class. 


internal  means  public  only  to  other  classes  in  an  assembly 

The  built-in  .NET  Framework  classes  are  assemblies — libraries  of  classes  that  are  in  your 
project's  list  of  references.  You  can  see  a  list  of  assemblies  by  right-clicking  on  “References” 
in  the  Solution  Explorer  and  choosing  “Add  Reference...”  when  you  create  a  new  Windows 
Forms  Application,  the  IDE  automatically  includes  the  references  you  need  to  build  a 
Windows  application.  When  you  build  an  assembly,  you  can  use  the  internal  keyword  to  keep 
classes  private  to  that  assembly,  so  you  can  only  expose  the  classes  you  want. 


sealed  says  that  this  class  can’t  be  subclassed 

There  are  some  classes  which  you  just  can’t  inherit  from.  A  lot  of  the  .NE1  Framework 
classes  are  like  this — go  ahead,  try  to  make  a  class  that  inherits  from  String  (that’s  the  class 
whose  IsEmptyOrNull()  method  you  used  in  the  last  chapter.)  What  happens?  The  compiler 
won't  let  you  build  your  code  it  gives  you  the  error,  “cannot  derive  from  settled  tvpe 
‘string’”.  You  can  do  that  with  your  own  classes  just  add  sealed  after  the  access  modifier. 
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minty  fresh  scope 


Access  modifiers  change  scope 

Let's  take  a  closer  look  at  the  access  modifers,  and  how  they  affect  the  scope 
of  the  various  class  members.  We  made  two  changes:  the  funny' Thingl  Have 
backing  field  is  now  protected,  and  we  changed  the  ScareLittleChildrenO 
method  so  that  it  uses  the  funnyThinglHave  field. 


Alike  these  two  changes  to 
your  own  exeCr.se  solution.  Then 
change  the  protected  access 
-nod.fier  back  to  private  and 
see  what  errors  you  get- 


public  interface  IClown  { 

string  FunnyThinglHave  {  get;  } 
void  Honk ( ) ; 

} 


The  "this"  keyword  also  changes  the  scope 
of-  a  variable  It  says  to  C#,  "Look  at 
the  Current  instance  of  the  class  to  find 
whatever  I'm  Connected  to— even  if  that 
matches  a  parameter  or  local  variable 


public  interface  IScaryClown  :  IClown 
string  ScaryThinglHave  {  get;  } 


void  ScareLittleChildrenO 


} 


This  is  a  really  Common  way  to 
use  "this",  Since  the  parameter 
and  backing  field  have  the  same 
name  funnyThinglHave  refers 
to  the  parameter,  while  this. 
funnyThinglHave  is  the  backing  field 


C#  that  we're 
talking  about 
the  backing 
field,  not  the 
parameter  that 
has  the  same 
name 


public  class  FunnyFunny  :  IClown  { 

"this"  wTtold  public  FunnyFunny  (string  funnyThinglHave)  { 

^this . funnyThinglHave  =  funnyThinglHave; 

}  ^  changed  this  to  protected 

protected  string  funnyThinglHave;^-  ^'ootc  sec  't  affects  the 
public  string  FunnyThinglHave  {  ^caryScaryScareLH:tleChildrenO 

get  {  return  "Honk  honk!  I  have  "  +  funnyThinglHave;  } 

} 

public  void  Honk()  { 

MessageBox . Show (this . FunnyThinglHave) ; 

1  A 


When  you  use  "this"  with  a  property,  it 
tells  C#  to  execute  the  set  or  get 
accessor. 
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Access  MoJflers 
lip  Close 


number(?fScaryTbinjs 

is  private,  which  is 

public  class  ScaryScary  :  FunnyFunny,  IScaryClown  {  -typical  o-f  a  backing 

public  ScaryScary  (string  funnyThinglHave  ,  field  S©  only  another 

int  numberOfScaryThings)  '^stance  of  ScaryScary 

"°uld  be  able  to  see  it- 

:  base (funnyThinglHave)  { 

this . numberOfScaryThings  =  numberOf ScaryThings ; £  ^ 


} 


private  int  numberOf ScaryThings ; 
public  string  ScaryThinglHave  { 

get  {  return  "I  have  "  +  numberOf ScaryThings  +  "  spiders";  } 

}  The  protected  keyword 

tells  to  make  something 
private  to  everyone  except 
instances  of  a  subclass 


A  C  l  L'Tr  to 

use  the  value  from  the  base  class.” 

Thats  another  way  to  change  scope 


public  void  ScareLittleChildren ( )  { 

MessageBox . Show ("You  can't  have  my  " 

+  base . funnyThinglHave) ;  J 

}  fc  If  «e'd  left 

this  would  Cause  the  Compiler  to  jive 
you  an  error  But  when  we  chanjed 
it  to  protected,  that  made  it  visible 
to  any  subclass  of  FunnyFunny 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 

ScaryScary  f ingersTheClown  =  new  ScaryScary ("big  shoes",  14); 
FunnyFunny  someFunnyClown  =  f ingersTheClown; 

IScaryClown  someOtherScaryclown  =  someFunnyClown  as  ScaryScary; 
someOtherScaryclown . Honk ( ) ; 

}  Since  this 

button  click 
event  handler 
is  not  part  of 
FunnyFunny  and 
ScaryScary,  it 
can’t  access 

the  protected  ft's  outside  of  both  classes,  so  the  statements 

funny ThinjIHave  < -  mside  it  only  have  access  to  the  public  members 

f  ield  of  any  FunnyFunny  or  ScaryScary  objects- 
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eew,  duplicate  code! 


the reifffe  n<? 

Durnb  Questions 


Qj  Why  would  I  want  to  use  an 
interface  instead  of  just  writing  all  of  the 
methods  I  need  directly  into  my  class? 

You  might  end  up  with  a  lot  of  different 
classes  as  you  write  more  and  more 
complex  programs.  Interfaces  let  you  group 
those  classes  by  the  kind  of  work  they  do. 
They  help  you  be  sure  that  every  class  that's 
going  to  do  a  certain  kind  of  work  does  it 
using  the  same  methods.  The  class  can  do 
the  work  however  it  needs  to  and,  because 
of  the  interface,  you  don't  need  to  worry 
about  how  it  does  it  just  to  get  the  job  done 

Here’s  an  example:  you  can  have  a 
truck  class  and  a  sailboat  class  that 
implement  ICarryPassenger.  Say 
the  ICarryPassenger  interface 
stipulates  that  any  class  that  implements 
it  has  to  have  a  ConsumeEnergy  ( ) 
method.  Your  program  could  use  them 
both  to  carry  passengers  even  though  the 
sailboat  class's  ConsumeEnergy  ( ) 
method  uses  wind  power  and  the  truck 
class's  method  uses  diesel  fuel. 

Imagine  if  you  didn't  have  the 
ICarryPassenger  interface.  Then  it 
would  be  tough  to  tell  your  program  which 
vehicles  could  carry  people  and  which 
couldn't.  You  would  have  to  look  through 
each  class  that  your  program  might  use 
and  figure  out  whether  or  not  there  was  a 
method  for  carrying  people  from  one  place  to 
another.  Then  you'd  have  to  call  each  of  the 
vehicles  your  program  was  going  to  use  with 
whatever  method  was  defined  for  carrying 
passengers  And  since  there's  no  standard 
interface,  they  could  be  named  all  sorts  of 
things  or  buried  inside  other  methods.  You 
can  see  how  that'll  get  confusing  pretty  fast. 


Q I  Why  do  I  need  to  use  a  property? 
CarYt  I  just  include  a  field? 

Good  question.  An  interface  only 
defines  the  way  a  class  should  do  a  specific 
kind  of  job.  It’s  not  an  object  by  itself,  so 
you  can't  instantiate  it  and  it  can't  store 
information.  If  you  added  a  field  that  was 
just  a  variable  declaration,  then  C#  would 
have  to  store  that  data  somewhere— and  an 
interface  can't  store  data  by  itself 

o 

V,-  What’s  the  difference  between  a 
regular  object  reference  and  an  interface 
reference? 

You  already  know  how  a  regular, 
everyday  object  reference  works  If  you 
create  a  instance  of  Skateboard 
called  VertBoard,  and  then  a  new 
reference  to  it  called  Half  PipeBoard, 
they  both  point  to  the  same  thing.  But  if 
Skateboard  implements  the  interface 
IStreetTricks  and  you  create  an 
interface  reference  to  Skateboard 
called  StreetBoard,  it  will  only  know 
the  methods  in  the  Skateboard  dass 
that  are  also  in  the  IStreetTricks 
interface. 

All  three  references  are  actually  pointing 
to  the  same  object.  If  you  call  the  object 
using  the  Half  PipeBoard  or 
VertBoard  references,  you'll  be  able  to 
access  any  method  or  property  in  the  object, 
If  you  call  it  using  the  StreetBoard 
reference,  you'll  only  have  access  to  the 
methods  and  properties  in  the  interface. 

ry 

N/.  Then  why  would  I  ever  want  to  use 
an  interface  reference  if  it  limits  what  I 
can  do  with  the  object? 


Interface  references  give  you  a  way 
of  working  with  a  bunch  of  different  kinds 
of  objects  that  do  the  same  thing.  You 
can  create  an  array  using  the  interface 
reference  type  that  will  let  you  pass 
information  to  and  from  the  methods  in 
ICarryPassenger  whether  your 
working  with  a  truck  object,  a  horse  object, 
a  unicycle  object,  or  a  car  object.  The  way 
each  of  those  objects  do  the  job  is  probably 
a  little  different,  but  with  interface  references, 
you  know  that  they  all  have  the  same 
methods  that  take  the  same  parameters  and 
have  the  same  return  types.  So,  you  can  call 
them  and  pass  information  to  them  in  exactly 
the  same  way. 

Qj  Why  would  I  make  something 
protected  instead  of  private  or  public? 

Because  it  helps  you  encapsulate  your 
classes  better.  There  are  a  lot  of  times  that  a 
subclass  needs  access  to  some  internal  part 
of  its  base  class.  For  example,  if  you  need 
to  override  a  property,  it's  pretty  common  to 
use  the  backing  field  in  the  base  class  in  the 
get  accessor,  so  that  it  returns  some  sort  of 
variation  of  it.  But  when  you  build  classes, 
you  should  only  make  something  public 
if  you  have  a  reason  to  do  it.  Using  the 
protected  access  modifier  lets  you  expose  it 
only  to  the  subclass  that  needs  it,  and  keep 
it  private  to  everyone  else 

Interlace  relerences 
only  know  about 
tke  methods  and 
properties  that 
are  delined  in  the 
interlace. 
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Some  classes  should  never  be  instantiated 

Remember  our  zoo  simulator  class  hierarchy?  You'll  definitely  end  up 
instantiating  a  bunch  of  hippos,  dogs  and  lions.  But  what  about  the 
Canine  and  Feline  classes?  How  about  the  Animal  class?  It  turns  out  that 
there  are  some  classes  that  just  don't  need  to  be  instantiated...  and.  in  fact, 
don't  make  any  sense  if  they  are.  Here’s  an  example. 

Let's  start  with  a  basic  class  for  a  student  shopping  at  the  student  bookstore, 
public  class  Shopper  { 

public  void  ShopTillYouDrop ( ) 

while  (TotalSpent  <  CreditLimit) 

BuyFavoriteStuff () ; 

} 

public  virtual  void  BuyFavoriteStuff  ()  ( 

//  No  implementation  here  -  we  don't  know 
//  what  our  student  likes  to  buy! 

1 

) 

Here’s  the  ArtStudent  class — it  subclasses  Shopper: 
public  class  ArtStudent  :  Shopper  ( 

public  override  void  BuyFavoriteStuff  ()  { 
BuyArtSupplies () ; 

BuyBlackTurtlenecks () ; 

BuyDepressingMusic ( ) ; 

} 

1 

And  the  EngineeringStudent  class  also  inherits  from  Shopper: 
public  class  EngineeringStudent  :  Shopper  { 
public  override  void  BuyFavoriteStuff  ()  ( 

BuyPencils  () ; 

BuyGraphingCalculator ( ) ; 

BuyPocketProtector () ; 

} 

) 


Shopper 


TotalSpent 

CreditLimit 


ShopTilYouDropf) 
BuyFavoriteStuff ) 


ArtStudent 

Engineering 

Student 

BuyFavonteStufff) 

BuyFavonteStufff) 

T 


.  7 

The  ArtStudent  and 
Enji  neerin^Student 
classes  both  override 
the  BuyFavoriteStuff  0 
method,  but  they  buy 
very  different  things. 


So  what  happens  when  you  instantiate  Shopper?  Does  it  ever  make  sense  to  do  it? 
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i  can't  believe  it’s  not  an  interface! 


Ah  abstract  class  is  like  a  cross 
between  a  class  and  an  interface 


Suppose  you  need  something  like  an  interface,  that  requires  classes  to 
implement  certain  methods  and  properties.  But  you  need  to  include  some 
code  in  that  interface,  so  that  certain  methods  don’t  have  to  lx*  implemented 
in  each  inheriting  class.  What  you  want  is  an  abstract  class.  You  get  the 
features  of  mi  interface,  but  you  can  write  code  in  it  like  a  normal  class. 


An  abstract  class  is  like  a  normal  class 

You  define  an  abstract  class  just  like  a  normal  one.  It  has  fields  and 
methods,  and  you  can  inherit  from  other  classes,  too,  exactly  like  with 
a  normal  class.  There’s  almost  nothing  new  to  learn  here,  because 
you  already  know  everything  that  an  abstract  class  does! 


An  abstract  class  is  like  an  interface 

When  you  create  a  class  that  implements  an  interface,  you  agree  to 
implement  all  of  the  properties  and  methods  defined  in  that  interface. 
An  abstract  class  works  the  same  way  it  can  include  declarations 
of  properties  and  methods  that,  just  like  in  an  interface,  must  be 
implemented  by  inheriting  classes. 


A  method  that  has  a  declaration  but 

ro  statements  or  method  body  is 
called  an  abstract  method  Inheriting 
classes  must  implement  all  abstract 
methods,  just  like  when  they  inherit 
-from  an  interface 

Only  abstract  classes  can  have  abstract 
methods.  If  you  put  an  abstract 
method  into  a  class,  then  you'll  have  to 
mark  that  class  abstract  or  it  won't 
Compile.  Vou'll  learn  more  about  how  to 
mark  a  class  abstract  in  a  minute 


But  an  abstract  class  can’t  be  instantiated 

The  biggest  difference  between  an  abstract  class  and  a  concrete 
class  is  that  you  can’t  use  new  to  create  an  instance  of  an  abstract 
class.  If  you  do,  G#  will  give  you  an  error  when  you  try  to  compile 
your  code. 


e 


Cannot  create  an  instance  of  the 
abstract  class  or  interface  'MyClass' 


] 


The  opposite  of  abstract 
is  Concrete  A  Concrete 
method  is  one  that  has  a 
body,  and  all  the  classes 
you’ve  been  working  with  SO 
far  are  concrete  classes. 


This  error  is  because  you  have 
abstract  methods  without  any 
Code^  The  Compiler  won’t  let  you 
instantiate  a  class  with  m.ssing 
Code,  just  like  it  wouldn't  let  you 
instantiate  an  interface 
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Herts  a  class  that  the  Objectville  m  examp,f 

Astrophysics  Club  uses  to  send  — 

thei*-  rockets  to  different  planets  ^ 

...  -  ,  .  .  I't  doesn  t  make  sense  to 

publxc  class  PlanetMission  {  ^  ^  ^  ^ 

public  long  RocketFuelPerMile;  k 

public  long  RocketSpeedMPH;  don't  know  what  ofiket 

public  int  MilesToPlanet;  J  >  .  >„  , 

y  or  planet  we  II  be  using 

public  long  UnitsOfFuelNeeded ( )  { 

return  MilesToPlanet  *  RocketFuelPerMile; 


eWait,  what?  A  class  that  I  can't  instantiate?  j 

Why  would  I  even  want  something  like  that?  . — ^ 

Because  you  want  to  provide  some  code,  but 

still  require  that  subclasses  fill  in  the  rest  of  the  code. 

Sometimes  bad  things  happen  when  you  create  objects  that  should  never  he 
created.  The  class  at  the  top  of  your  class  diagram  usually  has  some  fields  that  it 
expects  its  subclasses  to  set.  An  Animal  class  may  have  a  calculation  that  depends 
on  a  boolean  called  HasTail  or  Vertebrate,  but  there’s  no  way  for  it  to  set  that  itself. 

Here 's  an  example...  TKe  a*Wtys'**ts  have  two 

missions— one  to  /Wars,  and 

\  one  to  Venus.  \ 

It  doesn't  make  sense  to  ^ 

•  t  -n  srj.  ^.^ese  fields  m  the  public  class  Venus  :  PlanetMission  { 

rMile'>base  Class,  betalse  we C  public  Venus  ()  ( 

PH;  don't  know  what  rodket  MilesToPlanet  =  40000000; 

J  or  planet  we'll  be  usma  RocketFuelPerMile  =  100000; 

ceded ()  (  ”  RocketSpeedMPH  =  25000; 

RocketFuelPerMile; 


public  int  TimeNeeded ()  ( 

return  MilesToPlanet  /  RocketSpeedMPH; 

1 

public  string  FuelNeeded ()  { 
return  "You'll  need  " 

+  MilesToPlanet  *  RocketFuelPerMile 
+  "  units  of  fuel  to  get  there.  It'll  take 
+  TimeNeeded ()  +  "  hours."; 


public  class  Mars  :  PlanetMission  { 
public  Mars()  { 

MilesToPlanet  =  75000000; 
RocketFuelPerMile  =  100000; 
RocketSpeedMPH  =  25000; 

1 

]  The  Constructors  for  the  Mare  and  Venus 
subclasses  set  the  three  f  ields  they  inherited 
■fir  on»  Planet  But  those  fields  won't  <\et  set 
if  you  instantiate  Planet  directly  So  what 
happens  when  FuelNeededO  tries  to  use  them? 


private  void  buttonl_Click (object  s,  EventArgs  e)  { 
MarsMission  mars  =  new  Mars(); 

MessageBox .  Show  (mars .  FuelNeeded  ( ) ) ;  — — 


Vr»  ;1  n*«cJ  T300000G 
It!  tsfce  300C  hors 


1 1  nts  of  im  to  qr* 


private  void  button2_Click (object  s,  EventArgs  e)  ( 
VenusMission  venus  =  new  Venus (); 

MessageBox .  Show  (venus .  FuelNeeded  ( ) ) ;  ____ 


vail  nmJ  wowcoooooco  inc  of  i«l  c-  g«t 

It! U*  ■MX.hali 


private  void  button3_Click (object  s,  EventArgs  e)  { 
PlanetMission  planet  =  new  PlanetMission () ; 
MessageBox .  Show  (planet .  FuelNeeded  ( ) ) ; 


Before  you  flip  the  page,  try  to 
figure  out  what  will  happen  when 
the  user  clicks  the  third  button... 
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abstract  classes  avoid  this  mess 


Some  classes  should  never  be  instantiated 


The  problems  all  start  when  you  ornate  an  instance  ol'  the 
PlanetMission  class.  Its  FuelNeeded  ( )  method  expects 
the  fields  to  be  set  by  the  subclass.  But  when  they  aren't, 

(hey  get  their  default  values— zero.  And  when  C#  tries  to 
divide  a  number  by  zero... 

private  void  button3_Click (object  s,  EventArgs  e) 
PlanetMission  planet  =  new  PlanetMission  () ; 
MessageBox . Show (planet . FuelNeeded ( ) ) ; 

) 


Men  the  Fuel  Needed) 
_,thod  tried  to  divide 
SRoeketSrccdMPtt, 
it  was  Z rro  A"d  when 
-you  divide  t>Y 

havens 


The  Planet/VJission  class 
wdSh  t  written  to  be 

instantiated-  We  were 

fy  opposed  to  inherit 
Wn  it.  But  we  did,  and 
that  s  where  the  problems 
started. 


j\  DivideByZwoFxception  was  mil  wiK#ed 

X 

Attempted  to  dvOe  by  zero 

Trotbleshootlnq  tips: 

[Make  sure  the  value  of  the  deromrvator  s  not  zero  bef: 

re  perfornmg  a  drviscn  j 

A 

_ - ^ 

Get  general  hefc>  for  this  exception. 

V 

'  Search  for  mxe  Heb  Ontre  . 

Actions: 

View  Deaf  .. 

Copy  exception  detai  to  the  dpboard 

Solution:  use  an  abstract  class 


Adding  the  abstract  keyword  to  the  class 
declaration  tells  c#  this  is  an  abstract  class, 


When  you  mark  a  class  abstract.  G#  won’t  let  you  write 
code  to  instantiate  it.  It's  a  lot  like  an  interface — it  acts  like  a 
template  for  the  classes  lliat  inherit  from  it. 


and  Can’t  be  instantiated 


public  Qbstracl^)  class  PlanetMission  { 


No w  C$  will 
re-fuse  to  Compile 
our  program  until 
we  remove  the 
line  that  Creates 
an  instance  of 
Plane  t/k|ission 


public  long  RocketFuelPerMile ; 
public  long  RocketSpeedMPH ; 
public  int  MilesToPlanet ; 

public  long  Uni tsOf FuelNeeded ( )  { 

return  MilesToPlanet  *  RocketFuelPerMile; 


} 


//  the  rest  of  the  class  is  defined  here 

} 
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Aw  abstract  method  doesw't  have  a  body 

You  know  how  an  interface  only  has  declarations  for  methods  and 
properties,  but  it  doesn’t  actually  have  any  method  bodies?  That’s 
because  every  method  in  an  interface  is  an  abstract  method.  You 
can  have  abstract  methods  in  an  abstract  class,  too — but  you  need  to 
explicitly  mark  them  with  the  abstract  keyword,  because  an  abstract 
class  can  also  have  normal  methods,  too. 


public  abstract  class  PlanetMission  { 


Every  method  in 
an  interface  is 
automatically  abstract, 
so  you  don’t  need  to  use 
the  abstract  keyword 
in  an  interface,  just  in 
an  abstract  class.  Only 
abstract  classes  can 
have  abstract  methods... 
but  they  can  have 
concrete  methods  too. 


publicCabstract^void  SetMissionlnfo ( 

int  MilesToPlanet ,  int  RocketFuelPerMile , 
long  RocketSpeedMPH) ; 


//  the  rest  of  the  class. 


t» 

or  the  Yroyrdrr 

If  we  add  dial  method  in  mid  try  to  build 
the  program,  the  11)F.  gives  us  an  error: 


'VenusMission'  does  not  implement  inherited  abstract 
member  'PlanetMission. SetMissionInfo(long,  int,  int) 


So  let's  implement  it!  Once  we  do,  the  error  will  go  away. 

public  class  Venus  :  PlanetMission  { 
public  Venus ()  { 

SetMissinlnfo (40000000,  100000,  25000); 

) 


SetMissionlnfo (int  milesToPlanet,  long  rocketFuelPerMile,  int  rocketSpeedMPH)  { 
this .MilesToPlanet  =  milesToPlanet; 
this .RocketFuelPerMile  =  rocketFuelPerMile; 
this .RocketSpeedMPH  =  rocketSpeedMPH; 


} 
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worth  a  thousand  words 


3arpen  your  pencil 


k 


Here's  your  chance  to  demonstrate  your  artistic  abilities.  On  the  left  you'll  find  sets 
of  class  and  interface  declarations.  Your  job  is  to  draw  the  associated  class  diagrams 
on  the  right.  We  did  the  first  one  for  you.  Don't  forget  to  use  a  dashed  line  for 
implementing  an  interface  and  a  solid  line  for  inheriting  from  a  class. 


Wven: 


What's  the  Picture  ? 


1)  public  interface  Foo  I  } 
public  class  Bar  :  Foo  {  } 


1) 


l) 


public  interface  Vinn  {  } 

public  abstract  class  Vout  :  Vinn  {  | 


B* 


l) 


3) 

public  abstract  class  Muffie  :  Whuffie  {  } 
public  class  Fluffie  :  Muffie  (  ) 

public  interface  Whuffie  (  | 


4)  4) 

public  class  Zoop  {  ) 
public  class  Boop  :  Zoop  {  } 
public  class  Goop  :  Boop  {  ) 


5)  5) 

public  class  Gamma  :  Delta,  Epsilon  {  } 
public  interface  Epsilon  {  } 
public  interface  Beta  {  } 
public  class  Alpha  :  Gamma, Beta  (  } 

public  class  Delta  (  } 
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On  the  left  you'll  find  sets  of  class  diagrams.  Your  job  is  to  turn 
these  into  valid  C#  declarations.  We  did  number  1  for  you. 


Given: 


Click 

Clack 


Fee  | 

□ 

3 

F 

hzk 

What's  the  declaration  ? 

public  class  Click  {  } 
public  class  Clack  :  Click  {  } 

l) 

3) 

4) 


5) 


KEY 


extends 


■ 

i 

i 

implements 

class 

|_^^lac^ 

interface 

[  Clack 

J 

abstract  class 

Clack 

□ 

you  are  here  * 
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them’s  fightin  words 


Fireside  Chats 


Abstract  Class: 


Tonight's  talk:  An  abstract  class  and  an  interface  butt  heads 
over  the  pressing  question,  “Who’s  more  important?” 


Interface: 


1  think  it’s  obvious  who’s  more  important  between  the 
two  of  us.  Programmers  need  me  to  get  their  jobs  done. 

Let’s  face  it.  You  don’t  even  come  close. 

Nice.  This  oughta  be  good. 


You  can’t  really  think  you're  more  important  than 
me.  You  don’t  even  use  real  inheritance  you  only  get 
implemented. 


Better?  You’re  nuts.  I’m  much  more  tlexihle  than  you. 
I  can  have  abstract  methods  or  concrete  ones.  I  can 
even  have  virtual  methods  if  I  want.  Sure,  I  can’t  be 
instantiated  but  then,  neither  can  you.  And  I  can  do 
pretty  much  anything  else  a  regular  class  does. 


•0M 


’Ml 


Great,  here  we  go  again.  Interfaces  don’t  use  real 
inheritance.  Interfaces  only  implement.  That’s  just  plain 
ignorant  Implementation  is  as  good  as  inheritance,  in 
fact  it’s  better! 


Yeah?  What  if  you  want  a  class  that  inherits  from 
you  and  your  buddy?  You  can’t  inherit  from  two 
classes.  You  have  to  choose  which  class  to  inherit  from. 
And  that's  just  plan  rude!  There's  no  limit  to  the  number 
of  interfaces  a  class  can  implement.  Talk  about  flexible! 
With  me,  a  programmer  can  make  a  class  do  anything. 
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Abstract  Class: 

You  might  be  overstating  your  power  a  little  bit. 


Thai's  exactly  die  kind  of  drivel  I’d  expect  from  an 
interface.  Code  is  extremely  important!  It's  what 
makes  your  programs  run. 


Really?  I  doubt  that  programmers  always  care 
what’s  in  their  properties  and  methods. 


Yeah,  sure,  tell  a  coder  he  can’t  code. 


Interface: 


You  think  that  just  because  you  can  contain  code, 
you’re  the  greatest  thing  since  sliced  bread.  But 
you  can't  change  the  fact  that  a  program  can  only 
inherit  from  one  class  at  a  time.  So,  you’re  a  little 
limited.  Sure,  I  can’t  include  any  code.  But  really, 
code  is  overrated. 


Nine  times  out  of  ten,  a  programmer  wants  to  make 
sure  an  object  has  certain  properties  and  methods, 
but  doesn't  really  care  how  they’re  implemented. 


Okay,  sure.  Eventually.  But  think  about  how  many 
times  you've  seen  a  programmer  write  a  method 
that  takes  an  object  that  just  needs  to  have  a  certain 
method,  and  it  doesn’t  really  matter  right  at  that 
very  moment  exactly  how  the  method’s  built.  Just 
that  it’s  there.  So  bang!  The  programmer  just  needs 
to  write  an  interface.  Problem  solved! 


\  Vila  lever! 


2)  public  abstract  class  Top  {  } 
public  class  Tip  :  Top  {  } 


3)  public  abstract  class  Fee  {  } 
public  abstract  class  Fi  :  Fee  {  } 


4)  public  inter-face  Foo  {  } 
public  class  Bar  :  Foo  {  } 
public  class  Baz. :  Bar  {  } 


What's  the  Peclaratlon  ? 


5)  public  inter-face  Z-cta  {  } 

public  Class  Alpha  ■  Zeta  {  }  Alpha  and 

public  interface  Beta  {  }  / — 

public  class  Delta  :  Alpha,  Beta  {  } 


you  are  here  ► 


285 


multiple  inheritance  sucks 


I'm  still  hung  up  on  not  being  able  to  inherit  from  two  classes.  If  I 
can't  inherit  from  more  than  one  class,  so  I  have  to  use  interfaces. 
That's  a  pretty  big  limitation  of  C#,  right? 


It’s  not  a  limitation,  it’s  a  protection. 

If  C#  let  you  inherit  from  more  than  one  base  class,  it  would 
open  up  a  whole  can  of  worms.  When  a  language  lets  one 
sublcass  inherit  from  two  base  classes,  it's  called  multiple 
inheritance.  And  by  giving  you  interfaces  instead,  C#  saves 
you  from  a  big  fat  mess  that  we  like  to  call... 


The  Deadly  Diamond  of  Dettffi! 


Television  and  MovieTheater  both  inherit 
from  MoviePlayer,  and  both  overr.de  the 
ShowAMovieO  method  Both  inherit  the 
SereenMdth  property,  too 


MoviePlayer 


mt  ScreenWidth 


Eat() 


Television  k 


ShowAMovie() 


MovieTheater  l 


ShowAMovief) 


Ima^ne  that  Television  and 

Mov.eTheate  .  Theater  nee<*s  ^ 

What  happ^  ‘^eerJA/idth-say, 

use  both  valves  r  TV  movies  and 

u  show  both 

Mature 


HomeTheater  I 


Avoid  ambiguity! 


^  a-/Uw;  , 


A  language  that  allows  the  Deadly  Diamond  of  Death  can  lead  to  some 
pretty  uglv  situations,  because  you  need  special  rules  to  deal  with  this  kind 
of  ambiguous  situation...  which  means  extra  work  for  you  when  you’re 
building  your  program!  C#  protects  you  from  having  to  deal  with  this  by 
giving  you  interlaces.  If  Television  and  MovieTheater  are  interfaces 
instead  of  classes,  then  the  same  ShowAMovie  ( )  method  can  satisfy  both 
of  them.  All  the  interface  cares  about  is  that  there’s  some  method  called 
ShowAMovie ( ) . 
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Pool  Puzzle 


Your  job  is  to  take  code  snippets  from  the  pool  and  place  them 
into  the  blank  lines  in  the  code  and  output.  You  may  use  the 
same  snippet  more  than  once,  and  you  won't  need  to  use  all  the 
snippets.  Your  goal  is  to  make  a  set  of  classes  that  will  compile 
and  run  and  produce  the  output  listed. 


public  Nose  { 


string  Face  {  get;  ) 


public  abstract  class  . 

public  virtual  int  Ear() 

< 


return  7; 


public  Picasso (string  face) 

< 

=  face; 


public  virtual  string  Face  ( 

. {  . ;  ) 

) . 

string  face; 


public  class  :  ( 

public  Clowns ()  :  base ("Clowns")  (  ) 


public  class  . : . { 

public  Acts()  :  base ("Acts")  {  ) 
public  override  { 

return  5; 

>  »W,  tKe  tobr y  fomt-tKi,  is 

tomplcie  C#  program 

public  class  :  {  J 

public  override  string  Face  {  / 

I  get  (  return  "Of76";  )  ^ 

public  static  void  Main (string!]  args)  ( 
string  result  = 

Nose[]  i  =  new  Nose [3]; 

i [0]  =  new  Acts () ; 

i [ 1 ]  =  new  Clowns () 

i [2]  =  new  Of 7 6 () ; 

for  (int  x  =  0;  x  <  3;  x++)  ( 

result  +=  (  . +  "  " 

+  .  )  +  "\n"; 


MessageBox. Show (result)  ; 


Note:  each  snippet 
from  the  pool  can  be 
used  more  once!  a 


); 

Nose( );  class 

Of76( );  abstract 

Clowns( );  interface 

Picasso( );  jnt  Ear0 

Of76  [  ]  i  =  new  Nose[3];  this 
Of 76  [  3  ]  i;  this. 

Nose  [  ]  i  =  new  Nose( );  face 

Nose  [  ]  i  =  new  Nose[3h_  this.face 


get 

set 

return 


5  Acts 
7  Clowns 
7  Of76 


class 
5  class 
7  class 

7  public  class 


i.Ear(x) 
i[x].Ear() 
i[x].Ear( 
i  lx]  .Face 


Output 


Acts 
Nose 
Of  76 
Clowns 
Picasso 


Answers  on  page  306. 
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form  of...  a  bucket  of  eagles! 


Okay,  I  think  I've  got 
a  pretty  good  handle 
on  objects  now! 


The  idea  that  you  could  Combine 
your  dais  and  your  todt  into 
classes  and  objects  was  a 
revolutionary  one  when  it  was 
+<«t  introduced— but  that's  how 
you  ve  been  building  all  your  C# 
Programs  so  far,  so  you  can  think 
Ot  -t  as  just  plain  programming. 


You’re  an  object  oriented  programmer. 

There’s  a  name  for  what  you’ve  been  doing.  It’s  called 
object  oriented  programming,  or  OOP  Before 
languages  like  G#  came  along,  people  didn't  use 
objects  and  methods  when  writing  their  code.  They 
just  used  functions  (which  is  what  they  called  methods 
in  a  non-OOP  program)  that  were  all  in  one  place  as 
if  each  program  were  just  one  hig  static  class  that  only 
had  static  methods.  It  made  it  a  lot  harder  to  create 
programs  that  modeled  the  problems  they  were  solving. 
Luckily,  you’ll  never  have  to  write  programs  without 
OOP,  because  it's  a  core  part  of  C#. 


The  four  princpies  of  object  oriented  programming 


When  programmers  talk  about  OOP,  they’re  referring  to  four  important  principles. 
They  should  seem  very  familiar  to  you  by  now  because  you’ve  been  working 
with  every  one  of  them.  You’ll  recognize  the  first  three  principles  just  from  their 
names:  inheritance,  abstraction,  and  encapsulation.  The  last  one’s  called 
polymorphism.  It  sounds  a  little  odd,  but  it  turns  out  that  you  already  know  all 
about  it  too. 


This  just  means  having  one 
Class  or  in  ter -face  that 
inherits  -from  another 


i  1 1  *f  '•**•*»  -»5 

^  to  lot 

tko/ll*  'n^errui,  daU 

that  they  need  to  see 


*  Inheritance  <- 


Abstraction 


VouVe  using  abstraction  when  you 
create  a  class  model  that  starts  with 

more  general— or  abstract-classes, 

and  then  has  more  specif  ic  classes  ^ 
that  inherit  from  it- 


Encapsulation 


orpj 


tism 


The  word 

"polymorphism’  literally 
means  "many  forms  . 
Can  you  think  of  a 
time  when  an  object 
has  taken  on  many 
forms  in  your  Code? 
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Polymorphism  means  that  one  object  can 
take  many  different  forms 

Any  lime  you  use  a  mockingbird  in  place  of  an  animal  or  aged 
Vermont  cheddar  in  a  recipe  that  just  calls  for  cheese,  you’re  using 
polymorphism.  That’s  what  you’re  doing  any  time  you  upcast  or 
downcast.  It's  taking  an  object  and  use  it  in  a  method  or  a  statement  that 
expects  something  else 


Keep  your  eyes  open  for  polymorphism  In  the  next 
exercise! 

You're  about  to  do  a  really  big  exercise — the  biggest  one  you’ve  seen  so 
far — and  you’ll  be  using  a  lot  of  polymorphism  in  it.  So  keep  your  eyes 
open  for  it.  Here's  a  list  of  four  typical  ways  that  you'll  use  polymorphism. 
We  gave  you  an  example  of  each  of  them  (you  won't  see  these  particular 
lines  in  the  exercise,  though).  As  soon  as  you  see  similar  code  in  the  code 
that  you  write  for  the  exercise,  check  it  off  the  list. 


Taking  any  reference  variable  that  uses  one  class  and  setting  it 
equal  to  an  instance  of  a  different  class. 

NectarStinger  bertha  =  new  NectarStinger ()  ; 

INectarCollector  gatherer  =  bertha; 


You1  re  using 
polymorphism 
when  you  take  an 
instance  of  one 
class  and  use  it 
in  a  statement 
or  a  method  that 
expects  a  different 
type,  like  a 
parent  class  or  an 
interface  that  the 
class  implements. 


□ 


□ 


□ 


Upcasting  by  using  a  subclass  in  a  statement  or  method  that  expects  its 
base  class. 


spot  =  new  Dog ( ) ; 
zooKeeper . FeedAnAnimal (spot) ; 


** object 

U  Dog  .nhonis  (rom  ^  J 

pa«  Dog  to  fecdM^H).  ^ 


Creating  a  reference  variable  whose  type  is  an  interface  and 
pointing  it  to  an  object  dial  implements  that  interface. 

IStingPatrol  defender  =  new  StingPatrol ( ) ; 


.  This  is  uptasting.  too^ 


Downcasting  using  the  as  keyword, 
void  MaintainTheHive (IWorker  worker)  { 
if  (worker  is  HiveMaintainer)  { 

HiveMaintainer  maintainer  =  worker  as  HiveMaintainer; 


The  MaintainTheHive  ()  method 

takes  ar*  IWorker  as  a  ?ara~etrr  It 
uses  as  to  point  a  HiveMaintainer 

«{erente  th«  '"°'rke'r 
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let’s  get  started 


M 


t°  «£  Exercise 


Let’s  build  a  house!  Create  a  model  of  a  house  using  classes  to  represent  the 
rooms  and  locations,  and  an  interface  for  any  place  that  has  a  door. 


Start  with  this  class  model 

Every  room  or  location  in  your  house  w  ill  be  represented  by  its  own 
object.  The  interior  rooms  all  inherit  from  Room,  and  die  outside 
places  inherit  from  Outside,  which  subclass  the  same  base  class. 
Location.  It  has  two  fields:  Name  is  the  name  of  the  location 
(“Kitchen”),  and  Exits  is  an  array  of  Location  objects  that  the 
current  location  connects  to.  So  diningRoom.Name  will  lie  equal 
to  "Dining  Room",  and  diningRoom.  Exits  will  be  equal  to 
the  array  (  LivingRoom,  Kitchen  ). 

4  Create  a  Windows  Application  project  and  add 
Location,  Room  and  Outside  classes  to  it. 


Location 

Name 
Exits 


Description!) 


Location  is  an 
abstract  class 
That's  why 
x  shaded  it 
darker  the 
class  diagram 

rJ 


You'll  need  the  blueprint  for  the  house 

This  house  has  three  rooms,  a  front  yard,  and  a  garden. 
There  arc  two  doors:  the  front  door  connects  the  living 
room  to  die  front  yard,  and  the  back  door  connects  the 
kitchen  to  the  hack  yard. 


z 


Room 

Outside 

Decoration 

Hot 

The  living  room 
Connects  to 

the  d’mi«3  room, 
which  also 
Connects  to 
the  kitchen 


This  symbol  is  an  exterior  door 
between  the  -front  yard  and  the 
room.  There's  also  an  exterior  door 
between  the  kitchen  and  back  yard 


Dining 

Living  Room 

Room 

) _ 

Kitchen 

Use  the  IHasExteriorDoor  interface  for  rooms  with  an  exterior  door 

There  arc  two  exterior  doors  in  the  house,  the  front  door  and  the  back  door.  Every 
location  that  has  one  (the  front  yard,  back  yard,  liv  ing  room,  and  kitchen)  should 
implement  IHasExteriorDoor.  The  DoorDescription  read-only  property 
contains  a  description  of  the  door  (the  front  door  is  “an  oak  door  with  a  brass  knob”, 
the  back  door  is  “a  screen  door”).  T  he  DoorLocation  field  contains  a  reference  to 
the  Location  where  the  door  leads  (kitchen). 


Inside  locations  each  have 
some  kind  of  a  decoration 
in  a  read-only  property. 

Outside  locations  can  be  hot, 
so  the  Outside  class  has  a 
read-only  boolean  property 
called  Hot 

You  Can  move 
between  tbe  back 

Back  Yard  ]  Ya*rd  ar'd  tbe  -front 
yard,  and  both  of 
them  Connect  to  the 
garden 

All  rooms  have  doors,  but  only  a  few 
rooms  have  an  exterior  door  that 
leads  inside  or  outside  the  house 

X 


IHasExteriorDoor 

DoorDescription 
DoorLocation 
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/  Here's  the  Location  class 

To  get  you  started,  here’s  the  Location  class: 

public  abstract  class  Location  ( 
public  Location (string  name) 
this. name  =  name; 

Description  is  a  ) 

virtual  method  public  Location!]  Exits; 

You  II  «eed  to  S.  private  string  name; 
override  it-  A  public  string  Name  { 

get  {  return  name;  } 

) 


«■ 


r 

The  Description  property 
returns  a  string  that 
describes  the  room,  including 
the  name  and  a  list  °f  all 
of  the  locations  it  Connects 
to  (which  it  finds  in  the 
fcnitsCJ  field)  Its  subclasses 
will  need  to  change  the 
description  slightly)  so 
they’ll  override  it  ( 


The  Constructor  sets  the  name 
t-eld,  which  is  the  read-only  Name 
property  s  backing  f'dd 


TW.U.du 

location  connects  to  will  override 

- -  and  extend 


^  public  virtual  string  Description  {  - 

get  *1  " 

string  description  =  ''You'  re  standing  in  the  "  + 
+  You  see  exits  to  the  following  places: 
for  (int  i  =  0;  i  <  Exits. Length;  i++)  ( 
description  +=  "  "  +  Exits [i] .Name; 
if  (i  !=  Exits. Length  -  1) 
description  += 


) 

description  += 
return  description; 


Description 
name  to  add  the 
' ;  decoration, 
and  Outside 
will  add  the 
temperature 


Remember,  Location  is  an 
abstract  class-you  can 
inherit  from  it  and  declare 
reference  variables  of  type 
Location,  but  you  can't 
•w-fcantiate  it 


Create  the  classes 

First  create  the  Room  and  Outside  classes  based  on  the  class  model.  Then 
create  two  more  classes:  OutsideWithDoor,  which  inherits  from  Outside 
and  implements  IHasExteriorDoor,  and  RoomWi  thDoor.  which  subclasses 

^et  the  classes  started  now- 
details  about  them  on  the  ne*t  page 


Room  and  implements  IHasExteriorDoor. 
Here  are  the  class  declarations  to  give  you  a  leg  up: 


we  II  give  you  more 


public  class  OutsideWithDoor  :  Outside,  IHasExteriorDoor 

( 

//  The  read-only  DoorLocation  property  goes  here 
//  The  DoorDescription  property  goes  here 


public  class  RoomWithDoor  :  Room,  IHasExteriorDoor 

1 

//  The  read-only  DoorLocation  property  goes  here 
//  The  DoorDescription  property  goes  here 


This  one’s  going 
to  be  a  pretty  big 
exercise...  but  we 
promise  it’s  a  lot 
of  fun!  And  you’ll 
definitely  know  this 
stuff  once  you  get 
through  it. 


We’re  not  done  yet-fjip  the  page! 
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watch  your  objects  do  stuff! 


f.o h£  ExeRcvSe  (contiNuep) - 

Now  that  you've  got  the  class  model,  you  can  create  the  objects  for  all  of  the  parts  of  the 
house,  and  add  a  form  to  explore  it. 

How  your  house  objects  work 

Here’s  the  architecture  for  two  of  your  objects,  f  rontYard  and  diningRoom.  Since  each  of 
them  has  a  door,  they  both  need  to  be  instances  of  a  class  that  implements  IHasExteriorDoor. 

The  DoorLocation  property  keeps  a  reference  to  the  location  on  die  other  side  of  the  door. 

Livin^Room  is  an  ins  {ante  of 


•BackYard.l 

oyL/^oSWj- 


Fron-tVard  is  3n 
f  OutsideWithDoor 

/  object,  *hich  ,s  a 

suodass  Jc  Outside 

that  implements 

IHasExteriorDocr 


RoomWithDoor,  w/hiCh  inherits 
from  Room  and  implements 
IHasExteriorDoor 


side  oN 


o  l 

ExitsD 


You  started  buildintt  the  IHasExteriorDoor 
interface  and  add  these  two  classes  that  implement 
it  Due  inherits  from  Room,  the  other  is  a  subclass 
of  Outside-  Now  it's  time  to  f  inish  them- 

Finish  building  the  classes,  and  instantiate  their  instances 

You’ve  got  all  the  classes,  now  it’s  time  to  finish  them  and  build  your  objects. 


Exits  is  an  array  or  Location 
references  Livin^Room  has 
one  exit,  SO  its  Exits  array 
has  a  length  of  I. 


You'll  need  to  make  sure  that  the  constructor  for  the  Outside  class  sets  the  read-only  Hot  property  and 
overrides  the  Description  property  to  add  the  text  “It’s  very  hot  here.”  if  Hot  is  true.  It's  hot  in  the  hack 
yard  but  not  the  front  yard  or  garden. 

The  constructor  for  Room  needs  to  set  the  Decoration,  and  should  override  the  Description  property  to 
add,  “You  see  (the  decoration )  here.”  The  living  room  has  an  antique  carpet,  the  dining  room  has  a  crystal 
chandelier,  and  the  kitchen  has  stainless  steel  appliances  and  a  screen  door  that  leads  to  the  back  yard. 

Your  form  needs  to  create  each  of  the  objects  and  keep  a  reference  to  each  one.  So  add  a  method  to  the 
form  called  CreateObjects  ()  and  call  it  from  the  form's  constructor.  Every  location 

Instantiate  each  of  the  objects  for  the  six  locations  in  the  house.  Here’s  one  of  those  lines:  will  have  its 

own  field  in 
the  form  class 


RoomWithDoor  livingRoom  =  new  RoomWithDoor ("Living  Room", 

"an  antique  carpet"  ,  "an  oak  door  with  a  brass  knob") ; 

Your  CreateObjects  ( )  method  needs  to  populate  the  Exits  [  ]  field  in  each  object: 


Exits  is  an 
array  of  * 

Location 

references,  fr0ntYard.  Exits  =  new  Location  [  j^H'jbackYard,  garden 

so  this  line  ~  - 

Creates  one  and  that  — _ _ 

has  two  references  in  it 


These  are 
Curly  brackets 
-Anything  else  will 
cause  an  error 
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Build  a  form  to  explore  the  house 

Build  a  simple  form  to  let  you  explore  the  house.  It'll  have  a  big  multiline  textbox  called 
description  to  show  the  description  of  the  current  room.  A  ComboBox  called  exits  lists  all  of 
the  exits  in  the  current  room.  It’s  got  two  buttons:  goHere  moves  to  the  room  selected  in  the 
ComboBox,  and  goThroughTheDoor  is  only  v  isible  when  there’s  an  exterior  door.  .  .  >n 

8  8  5  rtert*s  where  you  ' 

sct  u?  what 


Click  the  goHerf 

button  to  move  to 
Another  locati  OTV 


Explore  the  House 


This  is  a  multiline  TextBoX  that 
displays  the  DescriptionO  of 
the  Current  location.  It’s  name 
is  description 


Go  here 


This  is  a  ComboBox 


Go  through  the  door 


O 


the  ComboBox^ 

The  ComboBox  Contains  a 
_  list  of  all  of  the  exits,  so 
name  it  exits  Make  sure 
its  DropDownStyle  is  set 
to  DropDownList 

This  button  is  only  visible 
when  you're  in  a  room  with 
an  exterior  door  You  Can 
make  it  visible  or  invisible  by 
setting  its  Visible  property 
to  true  or  false  Its  called 
goThroughTheDoor 


* 

* 


Now  you  just  need  to  make  the  form  work! 

You’ve  got  all  the  pieces,  now  you  just  need  to  put  them  together. 

You’ll  need  a  field  in  your  form  called  currentLocation  to  keep  track  of  your  current  location. .  J 

Add  a  MoveToANewLocationO  method  that  has  a  Location  as  its  parameter.  This  method  ^ 
should  first  set  currentLocation  to  the  new  location.  Then  it'll  clear  the  combo  box  using  its 
Items.Clear()  method,  and  then  add  the  name  of  each  location  in  the  Exits  [J  array  using  the 
combo  box’s  Items.Add()  method.  Finally,  reset  the  combo  box  so  it  displays  the  first  item  in  the 
list  by  setting  its  Selectedlndex  property  to  zero. 

Set  the  textbox  so  that  it  has  the  description  of  the  current  location. 

Use  the  is  keyword  to  check  if  the  current  location  has  a  door.  If  it  does,  make  the  “Go 
through  the  door”  button  visible  using  its  Visible  property.  If  not,  make  it  invisible. 

If  the  “Go  here:”  button  is  clicked,  move  to  the  location  selected  in  the  combo  box. 

If  the  “Go  through  the  door”  button  is  clicked,  move  to  the  location  that  the  door  coonects  to. 

t  Another  hint  /our  form's  CurrentLodaton  field  is 
»'  '  ' 


* 

* 


Bint  When  you  Choose  an  item  in  the  Combo  box,  its 
selected  index  in  the  Combo  box  will  be  the  same  as  the 
index  of  the  Corresponding  location  in  the  ExitsCJ  array 


Location  reference  So 


oecause  tzoor Location  isn't  a  field  in  Location- 
You'll  need  to  downcast  if  you  want  to  get  the  door 
location  out  of  the  object- 


you  are  here  > 
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t°  ExeRdSe 
SoLvt\OH 


Here's  the  code  to  model  the  house  We  used  classes  to  represent  the  rooms 
and  locations,  and  an  interface  for  any  place  that  has  a  door. 


public  interface  IHasExteriorDoor  | 
string  DoorDescription  (  get;  } 
Location  DoorLocation  {  get;  set;  } 

} 

public  class  Room  :  Location  { 
private  string  decoration; 


public  Room (string  name,  string  decoration) 
:  base (name)  { 

this .decoration  =  decoration; 

) 


s  the  IHasExteriorDoor  interface- 


The  Room  class  inherits  -from  Locate 
and  adds  a  backing  field  for  the 
read-only  Decoration  property  Its 
instructor  sets  the  field 


public  override  string  Description  { 
get  ( 

return  base. Description  +  "  You  see  "  +  decoration  + 

) 

} 


public  class  RoomWithDoor  ;  Room,  IHasExteriorDoor  ( 

public  RoomWithDoor (string  name,  string  decoration,  string  doorDescription) 
:  base (name,  decoration) 


{ 

this .doorDescription  =  doorDescription; 

} 

private  string  doorDescription; 
public  string  DoorDescription  ( 

get  {  return  doorDescription;  ) 

) 

private  Location  doorLocation; 
public  Location  DoorLocation  { 
get  (  return  doorLocation;  } 
set  (  doorLocation  =  value;  ) 

} 

) 


The  RoomWithDoor  class  inherits 
from  Room  and  implements 
IHasExteriorDoor  It  does  everything 
that  the  room  does,  but  it  adds  a 
description  of  the  exterior  door 
to  the  Constructor  It  also  adds 
DoorLocation,  a  reference  to  the 
location  that  the  door  leads  to 
DoorDesCripton  and  DoorLodation 
are  required  by  IHasExteriorDoor 
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Outside  is  a  lot  like  Room— it 
inherits  -from  Lodation,  2nd  adds  3 
backing  -field  for  the  Hot  property, 
whidh  is  used  in  the  DesdriptionO 
method  extended  from  the  base 
dlass. 

public  override  string  Description  ( 
get  { 

string  NewDescription  =  base . Description; 
if  (hot) 

NewDescription  +=  "  It's  very  hot."; 
return  NewDescription; 

) 

) 

} 


public  class  Outside  ;  Location  { 
private  bool  hot; 

public  bool  Hot  {  get  (  return  hot;  }  ) 

public  Outside (string  name,  bool  hot) 

:  base (name) 

{ 

this. hot  =  hot; 

) 


public  class  OutsideWithDoor  ;  Outside,  IHasExteriorDoor  ( 

public  OutsideWithDoor (string  name,  bool  hot,  string  doorDescription) 
:  base (name,  hot) 

{ 

this .doorDescription  =  doorDescript 


.  A 

iption;  \ 


) 


private  string  doorDescription; 
public  string  DoorDescription  ( 

get  {  return  doorDescription;  ) 

) 

private  Location  doorLocation; 
public  Location  DoorLocation  { 
get  (  return  doorLocation;  } 
set  (  doorLocation  =  value;  } 

) 


\  DutsidelVithDoor  inherits 
from  Outside  and  implements 
HasExtenorDoor,  and  ,t  looks  a  lot 
like  RoomlVithDoor. 


The  base  dlass's  Desdription  property 
f  ills  in  whether  or  not  the  lodation 
is  hot  And  that  relies  on  the  original 
Lodation  dlass's  Desdription  property 
to  add  the  main  desdription  and  exits 


public  override  string  Description  { 
get  ( 

return  base. Description  +  ”  You  see  "  +  doorDescription  + 

) 

) 

- ►  Were  not  done  yet-flip  the  page! 


you  are  here  ► 
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£ong  ExeRciSe 


S°Lyt\OH  (coHtinoGp) 

Here's  the  code  for  the  form.  It's  all  In  the  Forml.cs,  inside  the  Forml  declaration. 


public  partial  class  Forml  :  Form 
{ 

Location  currentLocation; 


RoomWithDoor  livingRoom; 
Room  diningRoom; 
RoomWithDoor  kitchen; 

OutsideWithDoor  frontYard; 
OutsideWithDoor  backYard; 
Outside  garden; 


This  is  how  the  form  keeps  track 
of  which  room  is  bem^  displayed 


The  -form  uses  these  reference 
variables  to  keep  brack  of  each 
ot  the  rooms  in  the  house 


public  Forml ()  { 

Initial izeComponent () ; 
CreateObjects () ; 
MoveToANewLocation (livingRoom) 

} 


'  )  The  form's  Constructor  Creates 

Y~  the  objects  and  then  uses  the 
\  MoveToA  NewLocation  method 

3m) 


IVhen  the  form  Creates 
the  objects,  first  it 

^ _ x - needs  to  instantiate 

the  classes  and  pass  the 

private  void  CreateObjects  ()  {  rijht  information  to 

livingRoom  =  new  RoomWithDoor  ("Living  Room",  "an  antique  carpet",  each  one’s  constructor 
"an  oak  door  with  a  brass  knob") ; 
diningRoom  =  new  Room("Dining  Room",  "a  crystal  chandelier"); 

kitchen  =  new  RoomWithDoor ("Kitchen",  "stainless  steel  appliances",  "a  screen  door"); 


frontYard  =  new  OutsideWithDoor ("Front  Yard",  false, 
backYard  =  new  OutsideWithDoor ("Back  Yard",  true,  "a_ 
garden  =  new  Outside ("Garden",  false); 


diningRoom. Exits  =  new  Location []  (  livingRoom,  kitchen 
livingRoom. Exits  =  new  Location!]  (  diningRoom  }; 
kitchen. Exits  =  new  Location!]  (  diningRoom  ); 
frontYard. Exits  =  new  Location!]  (  backYard,  garden  ); 
backYard. Exits  =  new  Location!]  {  frontYard,  garden  ); 
garden. Exits  =  new  Location!]  {  backYard,  frontYard  }; 

livingRoom. DoorLocation  =  frontYard;  J 
frontYard. DoorLocation  =  livingRoom;  / 

>  for  the  IHasBxier,orD, 

kitchen. DoorLocation  =  backYard;  \  objects,  we  need  to  set 
backYard. DoorLocation  =  kitchen;  their  door  locations. 


"an  oak  door  with  a  brass  knob"); 
screen  door") ; 

Here's  where  we  pass 
the  door  description  to 
the  OutsideWithDoor 
Constructors 


Here’s  where  the  E*itsCJ  array 
for  each  instance  is  populated 
We  need  to  wart  to  do  this 
until  after  all  the  instances  are 
CreabcA,  because  otherwise  we 
wouldn't  have  anything  to  put  into 
each  array! 
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private  void  MoveToANewLocation (Location  newLocation)  {  < - ) 

currentLocation  =  newLocation;  The  /HoveToMrw UafconO  „,eihod 

displays  a  \ocaho*  m  tKe  f< 

exits . Items . Clear ( ) ; 

for  (int  i  =  0;  i  <  currentLocation. Exits. Length;  i++) 
exits. Items .Add (currentLocation. Exi ts [i] .Name) 
exits. Selectedlndex  =  0; 


tori*. 


} 


description. Text  =  currentLocation . Description; 


if  (currentLocation  is  IHasExteriorDoor) 
goThroughTheDoor .Visible  =  true; 

else 

t  goThroughTheDoor. Visible  =  false; 

This  makes  ihe  "G\o  -through  ike  door"  buiion  invisible  if  ike 
turreni  lodaiion  doesn  i  implement  IHasEvieriorpoo r. 


turreni  location  doesn't  imple 

private  void  goHereClick (object  sender,  EventArgs  e)  { 

MoveToANewLocation (currentLocation . Exits [ exits . Selectedlndex ] ) ; 

) 

private  void  goThroughTheDoor_Click (object  sender,  EventArgs  e)  { 
IHasExteriorDoor  hasDoor  =  currentLocation  as  IHasExteriorDoor; 
MoveToANewLocation (hasDoor . DoorLocation) ; 

) 


First  we  need  io  dear  ike  Combo  bon, 
tken  we  can  add  eack  of  ike  locations 
names  io  it  Finally,  we  set  its  seleciecj 
inden  (or  wkick  line  is  highlighted) 
to  zero  so  it  skows  ike  f  irst  item 
in  ike  list  Don’t  forget  io  set  ike 
ComboBon’s  DropDownSiyle  property 
to  "DropDownList  — ikai  way  ike 
user  won't  be  able  io  type  anything 
into  ike  Combo  bon 


When  the  user  clicks 
ike  "£)o  here  ”  button, 
it  moves  io  ike 
locaton  selected  in 
ike  Combo  bon. 


* 


4 


We  need  io  use  ike  as  keyword  in  order 
to  downcast  CurrentLocation  io  an 
IHasEnteriorDoor  so  we  can  get  access  io 
ike  DoorLocation  field 


Put  we're  not  done  yet! 


4 


4 


It’s  fine  Id  create  a  model  of  a  house,  but  wouldn't  it  be  cool  to  turn  it  into  a  game? 
Let's  do  it!  You'll  play  Hide  and  Seek  against  the  computer.  We’ll  need  to  add  an 
Opponent  class  and  have  him  hide  in  a  room.  And  we’ll  need  to  make  the  house  a 
lot  bigger.  Oh.  and  he'll  need  someplace  to  hide!  We'll  add  a  new  interface  so  that 
some  rooms  can  have  a  hiding  place.  Finally,  we’ll  update  the  form  to  let  you  check 
the  hiding  places,  and  keep  track  of  how  many  moves  you’ve  made  trying  to  find 
your  opponent.  Sound  fun?  Definitely! 


4- 

Let’s  get  Started! 


you  are  here  ► 
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ExenciSe 


Time  for  hide  and  seek!  Build  on  your  original  house  program  to  add  more  rooms,  hiding 
places,  and  an  opponent  who  hides  from  you.  r  .  ^  3rd  use  -the  ID£'* 

“Add  I W  feaU«  kfi  3dd  Ike 

Add  an  IHidingPlace  interface  tlasses  tKe  ^ 

We  don't  need  to  do  anything  fancy  here.  Any  Location  subclass  that  implements  IHidingPlace 
has  a  place  for  the  opponent  to  hide.  It  just  needs  a  string  to  store  the  name  of  the  hiding  place  (“in 
the  closet”,  “under  the  bed”,  etc.) 


*  Give  it  a  get  accessor,  but  no  set  accessor— we’ll  set  this  in  the  constructor,  since  once  a  room 
has  a  hiding  place  we  won’t  ever  need  to  change  it. 

Add  classes  that  implement  IHidingPlace 

You'll  need  two  more  classes:  OutsideWithHidingPlace  (which  inherits  from  Outside)  and 

RoomWithHidingPlace  (which  inherits  from  Room).  Also,  let’s  make  any  room  with  a  door  have  a 

hiding  place,  so  it'll  have  to  inherit  from  RoomWithHidingPlace  instead  of  Room.  e*-terior 

Add  a  class  for  your  opponent  - — door  will  also  have  a  hidm^  ?'ate 

The  Opponent  object  will  find  a  random  hiding  place  in  the  house,  and  it’s  your  job  to  find  him. 

*  He'll  need  a  private  Location  field  (myLocation)  so  he  can  keep  track  of  where  he  is,  and  a 
private  Random  field  (random)  to  use  when  he  moves  to  a  random  hiding  place. 

*  The  constructor  takes  the  starting  location  and  sets  myLocation  to  it,  and  sets  random  to  a 
new  instance  of  Random.  He  starts  in  the  front  yard  (that'll  be  passed  in  by  form),  and  moves 
front  hiding  place  to  hiding  place  randomly.  He  moves  1 0  limes  when  the  game  starts.  When 
he  encounters  an  exterior  door,  he  flips  a  coin  to  figure  out  whether  or  not  to  go  through  it. 

*  Add  a  Move  ( )  method  that  moves  the  opponent  from  his  current  location  to  a  new  location. 

First,  if  he’s  in  a  room  with  a  door,  then  he  flips  a  coin  to  decide  whether  or  not  to  go  through 
the  door,  so  if  random .  Next  ( 2 )  is  equal  to  I .  he  goes  through  it.  Then  he  chooses  one  of 
the  exits  from  his  current  location  at  random  and  goes  through  it.  If  it  doesn't  have  a  hiding 
place,  then  he’ll  do  it  again  he’ll  choose  a  random  exit  from  his  current  location  and  go 
there,  and  he’ll  keep  doing  it  over  and  over  until  he  finds  a  place  to  hide. 

*  Add  a  Check  ( )  method  that  takes  a  location  as  a  parameter  and  returns  true  if  he’s  hiding 
in  that  location,  or  false  otherwise. 

Add  more  rooms  to  the  house 

Update  your  CreateObjects  ( )  method  to  add  more  rooms: 

*  Add  stairs  with  a  wooden  bannister  that  connect  the  liv  ing  room  to  the  upstairs  hallw  ay, 
which  has  a  picture  of  a  dog  and  a  closet  to  hide  in. 

*  Fite  upstairs  hallway  connects  to  three  rooms:  a  master  bedroom  with  a  large  bed,  a 
second  bedroom  with  a  small  bed,  and  a  bathroom  with  a  sink  and  a  toilet.  Someone 
could  hide  under  the  bed  in  either  bedroom  or  in  the  shower. 

*  The  front  yard  and  back  yard  both  connect  to  the  driveway,  where  someone  could  hide  in 
the  garage.  Also,  someone  could  hide  in  the  shed  in  the  garden. 
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Okay,  time  to  update  the  form 

You'll  need  to  add  a  lew  buttons  to  the 


m 


'kay,  time  to  update  the  form 

iu'11  need  to  add  a  few  buttons  to  the  form.  And  we’ll  set  a  little  more  intricate  with 
taking  them  visible  or  invisible,  depending  on  the  state  of  the  gr 


*  Hide  and  Seek 


wW.le  the  op*  is  n-ij  > 

When  ce  p*  ^  stMs>  I 

Me  bufon  is  the  only  one  displayed-  \> 

^hen  youdiek  it  ike  CoJts-v.  C 

to  10  m  the  text  box,  and  tails  the  '  ' 
opponents  MoveO  method  10  times. 

Then  rt  makes  this  button  invisible. 

Make  the  buttons  work 

There  are  two  new  buttons  to  add  to  the  form. 


Rame'  The  middle  WtW*  tailed  thetkVou 

don't  need  to  set  its  Text  f«*ert* 
This  is  the  button  you'll  use  to 

dhetk  the  room’s  hiding  plate  Its 
only  visible  if  you’re  m  3  room  that 

J  a  Plate  toh.de.  When  .tsshoxn, 

"the  Text  property  is 
"butW"  to  "Chetk  followed  by 
the  name  of  the  hiding  ?'^e"so 
for  a  room  With  a  hiding  plate 
under  the  bed,  the  button  will  say, 
"Chetk  under  the  bed 


Flip  batk  to  *  The  middle  button  checks  the  hiding  place  in  the  current  room  and  is  only  visible  when 
Chapter  2-  for  you’re  in  a  room  with  a  place  to  hide  using  the  opponent’s  Check  ( )  method.  If  you  found 

a  refresher  on  him.  then  it  resets  the  game. 

The  bottom  button  is  how  you  start  the  game.  It  counts  to  10  by  showing  “1...”,  waiting  200 
milliseconds,  then  showing  “2...”,  then  “3...”,  etc.  in  the  text  box.  After  each  number,  it  tells 
the  opponent  to  move  by  calling  his  Move  ( )  method.  Then  it  shows,  “Ready  or  not,  here  I 
come!”  for  half  a  second,  and  then  the  game  starts. 

Add  a  method  to  redraw  the  form,  and  another  one  to  reset  the  game 

Add  a  RedrawForm  ( )  method  that  puts  the  right  text  in  the  description  textbox,  makes  the  buttons 
visible  or  invisible,  and  puts  the  correct  label  on  the  middle  button.  Then  add  a  ResetGame  () 
method  that’s  run  when  you  find  the  opponent.  It  resets  the  opponent  object  so  that  he  starts  in  the 
front  yard  again — he'll  hide  when  the  user  clicks  the  “Hide!”  button.  It  should  leave  the  form  with 
nothing  but  the  text  box  and  “Hide!”  button  visible.  The  text  box  should  say  where  you  found  the 
opponent,  and  how  many  moves  it  took. 

Keep  track  of  how  many  moves  the  player  made 

Make  sure  the  text  box  displays  the  number  of  times  the  player  checked  a 
hiding  place  or  moved  between  rooms.  When  you  find  the  opponent,  he 
should  pop  up  a  mesage  box  that  says,  “You  found  me  in  X  moves!” 

Make  it  look  right  when  you  start  the  program 

When  you  first  start  the  program,  all  you  should  see  is  an  empty  text  box 
and  the  “Hide!”  button.  When  you  click  the  button,  the  fun  begins! 


DoFventsO  and  * 
SleeyO— they’ll 
Come  in  handy 


you  are  here  ► 
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Excise 

Solution 


Build  on  your  original  house  program  to  add  more  rooms,  hiding  places,  and  an  opponent  who 
hides  from  you  Here',  the  «.  (Hirfa^he,  i^erW  It 

^  jusi  has  one  string  field  with  a  get  accessor 
/  «turw  the  name  of  the  hiding  plate 


public  interface  IHidingPlace  { 

string  HidingPlaceName  {  get;  ) 


public  class  RoomWithHidingPlace  :  Room,  IHidingPlace  { 

public  RoomWithHidingPlace (string  name,  string  decoration,  string  hidingPlaceName) 
:  base (name,  decoration) 

{ 

this. hidingPlaceName  =  hidingPlaceName; 

>  n  ieMLLt  /lass  inherits 


private  string  hidingPlaceName; 
public  string  HidingPlaceName  { 

get  (  return  hidingPlaceName;  ) 

) 


The  RoomWithHidingPlace  class  inherits 
from  Room  and  implements  IHidmgPlate  by 
adding  the  HidingPlaceName  property.  7  he 
constructor  sets  its  backing  field 


public  override  string  Description  ( 
get  { 

return  base . Description  +  "  Someone  could  hide  "  +  hidingPlaceName  + 

) 

}  » 

public  class  RoomWithDoor  :  RoomWithHidingPlace,  IHasExteriorDoor  ( 
public  RoomWithDoor (string  name,  string  decoration, 

string  hidingPlaceName,  string  doorDescription) 

:  base (name,  decoration,  hidingPlaceName) 

this.  doorDescription  =  doorDescriptionr^v  **  decided  every  room  with  a 

j  door  also  needed  a  hiding  place,  we 


private  string  doorDescription; 
public  string  DoorDescription  { 

get  (  return  doorDescription;  ) 

) 

private  Location  doorLocation; 
public  Location  DoorLocation  ( 
get  (  return  doorLocation;  } 
set  (  doorLocation  =  value;  ) 

) 


Since  we  decided  every  room  with  a 
door  also  needed  a  hiding  place,  we 
made  RoomWithDoor  inherit  from 
RoomWithHidingPlace.  The  only 
change  to  it  IS  that  its  constructor 
takes  a  hiding  place  name  and  sends 

•t  on  to  the  RoomWithHidingPlace 

Constructor. 
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public  class  OutsideWithHidingPlace  :  Outside,  IHidingPlace  { 

public  OutsideWithHidingPlace (string  name,  bool  hot,  string  hidingPlaceName) 
:  base (name,  hot) 

(  this .hidingPlaceName  =  hidingPlaceName;  ) 

private  string  hidingPlaceName; 
public  string  HidingPlaceName  { 

get  {  return  hidingPlaceName;  ) 

) 


,The  OutsideWithHidingPlace  class  inherits 
from  Outside  and  implements  IHidingPlace 
just  like  RoomWithHidingPlace  does 


) 


public  override  string  Description 
get  ( 

return  base. Description  +  v 

) 

) 


Someone  could  hide  "  +  hidingPlaceName  + 


The  Opponent  class  constructor  takes  a 
starting  location  It  Creates  a  new  instance 
a f  Random,  which  it  uses  to  move  randomly 
between  rooms. 


( 


public  class  Opponent  < 

private  Random  random; 
private  Location  myLocation; 
public  Opponent (Location  startingLocation) 
myLocation  =  startingLocation; 
random  =  new  Random ( ) ; 

public  void  Move()  {  "  ’  " 

if  (myLocation  is  IHasExteriorDoor)  { 

IHasExteriorDoor  LocationWithDoor  = 

myLocation  as  IHasExteriorDoor; 
if  (random. Next (2)  ==  1) 

myLocation  =  LocationWithDoor . DoorLocation^ 

bool  hidden  =  false;  keeps  looping  un,.  -  -  - 

while  (hidden)  <  it  to  true  when  it  f‘«b  a  **  a  ^ 

int  rand  =  random. Next (0,  myLocation. Exits. Length) ; 
myLocation  =  myLocation . Exits [rand] ; 
if  (myLocation  is  IHidingPlace) 
hidden  =  true; 

) 


The  MoveO  method  first  checks  if  the  Current 
room  has  a  door  using  the  is  keyword— if  so,  it 
has  a  50  A  chanCe  o-f  going  through  it-  Then  it 
moves  to  a  random  locaiton,  and  keeps  moving 
until  it  finds  a  hiding  place 


oor .DoorLocation;  ,  .  i  _  il 

The  guts  of  the  MoveO  method  is  this  while  loop.  It 

I.  -I _ .—^1  the  variable  hidden  is  true— and  it  sets 


) 

public  bool  Check (Location  locationToCheck) 
if  (locationToCheck  !=  myLocation) 
return  false; 

else 

return  true; 

} 


I  / _ The  CheckO  method  just  checks  the 

Opponent  S  location  against  the  location 
that  was  passed  to  if  using  a  Location 
reference  |f  they  point  tio  the  same 
object,  then  he’s  been  found^ 


We’re  not  done  yet-flip  the  page! 
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ExeRaSe 

§OLut»OH 

(coHtiHoep) 


Here  are  all  the  -fields  m  the  T"oriJ 
tlass  |t  uses  them  to  keep  track  of 
the  locations,  the  opponent  and  the 
number  of  moves  the  flayer  has  made 


The  Form!  constructor  Creates  the  objects, 
sets  up  the  opponent,  and  then  resets  the  game 
We  added  a  boolean  parameter  to  Reset&meO 
so  that  it  only  displays  its  message  when  you 
win,  not  when  you  first  start  up  the  program 


int  Moves; 

Location  currentLocation; 

RoomWithDoor  livingRoom; 
RoomWithHidingPlace  diningRoom; 
RoomWithDoor  kitchen; 

Room  stairs; 

RoomWithHidingPlace  hallway; 
RoomWithHidingPlace  bathroom; 
RoomWithHidingPlace  masterBedroom; 
RoomWithHidingPlace  secondBedroom; 


public  FormlO  {  OutsideWithDoor  frontYard; 

InitializeComponent () ;  OutsideWithDoor  backYard; 

CreateObjects ( ) ;  OutsideWithHidingPlace  garden; 

opponent  =  new  Opponent (frontYard) ;  OutsideWithHidingPlace  driveway; 

ResetGame (false) ; 

)  Ny^Opponent  opponent; 

private  void  MoveToANewLocat ion (Location  newLocation)  { 

Moves++; 

currentLocation  =  newLocation; 

RedrawForm ( ) ;  v 

The  MoveToANewLoCat'onO  method  sets  the 

private  void  RedrawForm  ()  (  location  and  then  redraws  the  kor" 

exits . I terns . Clear ( ) ; 

for  (int  i  =  0;  i  <  currentLocation. Exits. Length;  i++) 
exits . Items. Add (currentLocation. Exits [i] .Name) ; 
exits. Selectedlndex  =  0; 

description .Text  =  currentLocation. Description  +  ”\r\n(move  #"  +  Moves  +  ")"; 

if  (currentLocation  is  IHidingPlace)  {  _ _ 

IHidingPlace  hidingPlace  =  currentLocation  {asj”lHidingPlace;  he*d  the  hiding  | 
check. Text  =  "Check  "  +  hidingPlace. HidingPlaceName;  name,  ut  we  ve  only 

check. Visible  =  true;  CurrentLocation  ob 

j  doesn  t  have  a  Hidim 

else  Property,  so  we  can 

check. Visible  =  false;  re^<re 

if  (currentLocation  is  IHasExteriorDoor )  '  ingPlaCe  variable- 

goThroughTheDoor .Visible  =  true; 

else 

goThroughTheDoor . Visible  =  false;  RedrawFormO  populates  the  Combo  bon  list,  sets  the 
j  tent  (adding  the  number  of  moves),  and  then  makes 

the  buttons  visible  or  invisible  depending  on  whether 
or  not  there's  a  door  or  the  room  has  a  hiding  place 


We  need  the  hiding  place 
name,  but  we've  only  got  the 
CurrentLocation  object  which 
doesn't  have  a  HidmgPlace/'/ame 
Property,  so  we  can  use  as  to 
downcast  the  reference  to  an 
IHidingPlace  variable 
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Wow— you  Could  add  an  entire  win<j  onto  the  house  just 
by  adding  a  couple  of  lines^  That’s  \why  well-encapsulated 
classes  and  objects  are  really  useful 

private  void  CreateObjects 0  ( 

livingRoom  =  new  RoomWithDoor ("Living  Room",  "an  antique  carpet", 

"inside  the  closet",  "an  oak  door  with  a  brass  handle"); 
diningRoom  =  new  RoomWithHidingPlace ("Dining  Room",  "a  crystal  chandelier", 

"in  the  tall  armoire"); 

kitchen  =  new  RoomWithDoor ("Kitchen",  "stainless  steel  appliances", 

"in  the  cabinet",  ”a  screen  door") ; 
stairs  =  new  Room ("Stairs",  "a  wooden  bannister"); 

hallway  =  new  RoomWithHidingPlace ("Upstairs  Hallway",  "a  picture  of  a  dog", 

"in  the  closet"); 

bathroom  =  new  RoomWithHidingPlace ("Bathroom",  ”a  sink  and  a  toilet", 

"in  the  shower"); 

masterBedroom  =  new  RoomWithHidingPlace ("Master  Bedroom",  "a  large  bed", 

"under  the  bed"); 

secondBedroom  =  new  RoomWithHidingPlace ("Second  Bedroom",  "a  small  bed", 

"under  the  bed"); 

frontYard  =  new  OutsideWithDoor ("Front  Yard",  false,  "a  heavy-looking  oak  door"); 
backYard  =  new  OutsideWithDoor ("Back  Yard",  true,  "a  screen  door"); 
garden  =  new  OutsideWithHidingPlace ("Garden",  false,  "inside  the  shed") ; 
driveway  =  new  OutsideWithHidingPlace ("Driveway",  true,  "in  the  garage"); 

diningRoom. Exits  =  new  Location[]  (  livingRoom,  kitchen  ); 
livingRoom. Exits  =  new  Location []  {  diningRoom,  stairs  }; 
kitchen. Exits  =  new  Location []  {  diningRoom  }; 
stairs. Exits  =  new  Location []  {  livingRoom,  hallway  ); 

hallway .Exits  =  new  Location []  (  stairs,  bathroom,  masterBedroom,  secondBedroom  ); 

bathroom. Exits  =  new  Location[]  {  hallway  ); 

masterBedroom. Exits  =  new  Location!]  (  hallway  ); 

secondBedroom. Exits  =  new  Location!)  (  hallway  ); 

frontYard. Exits  =  new  Location!]  (  backYard,  garden,  driveway  }; 

backYard. Exits  =  new  Location!]  (  frontYard,  garden,  driveway  ); 

garden. Exits  =  new  Location!]  {  backYard,  frontYard  ); 

driveway. Exits  =  new  Location!]  !  backYard,  frontYard  ); 

livingRoom. DoorLocation  =  frontYard;  Tbe  new  CreateObjectsO  method 

frontYard. DoorLocation  =  livingRoom;  Creates  all  tbe  objects  to  build  tbe 

bouse  It’s  a  lot  like  tbe  old  ore,  but  it 

kitchen. DoorLocation  =  backYard;  has  a  wK0le  lot  wore  places  to  50. 

backYard. DoorLocation  =  kitchen; 

- ►  We  re  still  not  done-flip  the  page! 


you  are  here  ► 
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oops,  /  did  it  again 


ExeRctSe 

S°Lut»o 


IvttOH  (contlNuep) 


Here’s  the  rest  of  the  Code  for  the  -form  The  goHere  and 
goThroughTheDoor  button  event  handlers  are  identical  to 
S'  the  ones  in  the  first  part  ©f  this  exercise,  so  flip  back  a  few 
J I  pages  to  see  them. 


private  void  ResetGame (bool  displayMessage)  { 
if  (displayMessage)  { 

MessageBox. Show ("You  found  me  in  "  +  Moves  +  ”  moves!"); 
IHidingPlace  foundLocation  =  currentLocation  IHidingPlace; 
description. Text  =  "You  found  your  opponent  in  "  +  Moves 

+  "  moves!  He  was  hiding  "  +  foundLocation. HidingPlaceName 


Moves  =  0; 

hide. Visible  =  true; 
goHere. Visible  =  false; 
check. Visible  =  false; 
goThroughTheDoor .Visible  =  false; 
exits. Visible  =  false; 


private  void  check_Click (object  sender,  EventArgs  e) 
Moves++;  \ 

if  ( opponent. Check (currentLocation) )  J 

ResetGame (true) ;  _  _ ' 

else  [ 

RedrawForm ( ) ;  J  ^ - 


private  void  hide_Click (object  sender,  EventArgs  e) 
hide. Visible  =  false; 


for  (int  i  =  1;  i  <=  10;  i++)  { 
opponent . Move ( ) ; 
description. Text  =  i  +  "...  "; 
Application. DoEvents () ; 

System . Threading . Thread . Sleep (200 ) ; 


The  Reset^ameO  method  resets  the  game  It 
displays  the  final  message,  then  makes  all  the 
buttons  except  the  "Hide./"  one  invisible. 


We  '“Jut  to  display  the  name  of  the 
hiding  place,  but  CurrentLocation  is  a 
Location  reference,  so  it  doesn't  give 
us  access  to  the  HidingPlaceName  field- 
Luckily,  we  can  us<  the  as  keyword  to 
downcast  it  to  an  IHidingPlace  reference 
that  points  to  the  same  object 


description. Text  =  "Ready  or  not,  here 
Application . DoEvents <) ; 

System. Threading. Thread. Sleep (500) ; 

goHere. Visible  =  true; 
exits .Visible  =  true; 
MoveToANewLocation (livingRoom) ; 


come ! " ; 


tVhen  you  click  the  check 
button,  it  checks  whether  or 
not  the  opponent  is  hiding  in 
the  Current  room  If  he  is,  it 
resets  the  game  If  not,  it 
redraws  the  form  (to  update 
the  number  of  moves). 


The  hide  button  is  the  one  that  starts  the 
v„e  The  f  irst  thing  .t  does  .s  make  itself 
invisible  Then  it  Counts  to  10  and  tells  the 
opponent  to  move.  Finally,  it  makes  the  f  irst 
button  and  the  Combo  box  Visible,  and  then 
starts  off  the  player  in  the  living  room 
THe  MoveToANewLoeationO  method  calls 
RedrawFormO. 
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Objectcross 


Down 

1.  When  you  move  common  methods  from  specific  classes  to 
more  a  general  class  that  they  all  inherit  from,  you're  using  this 
OOP  principle 

2.  If  a  dass  that  implements  an  interface  doesn't  implement  all 
of  its  methods,  getters  and  setters,  then  the  project  won't 


5.  Everything  in  an  interface  is  automatically 
7.  An  abstract  dass  can  indude  both  abstract  and 

_ methods 

9.  You  can't _ an  abstract  class 

11  A  class  that  implements  this  must  include  all  of  the  methods, 
getters  and  setters  that  it  defines 

12.  What  you  do  with  an  interface 

13.  The  is  keyword  returns  true  if  an _ implements 

an  interface 

16.  An  interface  can’t  technically  include  a _ .  but  it 

can  define  getters  and  setters  that  look  just  like  one  from  the 
outside 


Across 

3.  What  an  abstract  method  doesn't  have 

4  C#  doesn't  allow _ inheritance 

6.  When  you  use  a  pass  subclass  to  a  method  that  expects  its 
base  class,  you're  using  this  OOP  principle 
8  The  OOP  principle  where  you  hide  private  data  and  only 
expose  those  methods  and  fields  that  other  dasses  need 
access  to 

10.  One  of  the  four  principles  of  OOP  that  you  implement  using 
the  colon  operator 

14.  Every  method  in  an  interface  is  automatically _ 

15.  Your  class  that  implements  an  interface  that _ 

from  another  interface,  then  you  need  to  implement  all  of  its 
members  too 

17  An  access  modifier  that's  not  valid  for  anything  inside  an 
interface 

18.  Object _ Programming  means  creating  programs 

that  combine  your  data  and  code  together  into  dasses  and 
objects 


you  are  here  ► 
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Pool  Puzz]e  §o]iffion  front  page  287 

Your  job  is  to  take  code  snippets  from  the  pool  and  place  them 
into  the  blank  lines  in  the  code  and  output.  You  may  use  the 
same  snippet  more  than  once,  and  you  won't  need  to  use  all  the 
snippets.  Your  goal  is  to  make  a  set  of  classes  that  will  compile 
and  run  and  produce  the  output  listed. 

fWs  where  the  Mi S  class  calls  ike  Constructor 
m  Picasso,  which  ,i  inherits  from.  |t  passes  "Mis" 
into  the  Constructor,  which  gets  stored  in  the  (ace 
property 


public  interface  Nose  { 
int  £ar()  ; 

string  Face  {  get;  ) 

} 

public  abstract  class  Picasso  :  Nose 
public  virtual  int  Ear() 

< 

return  7; 

} 

public  Picasso (string  face) 

< 

this.face  .  =  face; 

) . 


Acts  , ;  ...Picasso.  ]j..{ 


public  class 

public  Acts()  :  base ("Acts")  (  ) 
public  override  int  Ear()  { 
return  5; 


} 


) 


) 


public  virtual  string  Face  {  but  it  s  perfectly 
get  {  return  face  ;  )  valid  to  have  the 

) .  (ate  property  at 

string  face;  the  botto**  of  the 

Picasso  class. 


public  class  Clowns  :  Picasso  { 

public  Clowns ()  :  base ("Clowns")  (  ) 

) 


public  class  Of76  :  Clowns  { 
public  override  string  Face  ( 

Properties  Can  get  |  return  "Of 7 6";  > 

appear  anywhere  m  ) 

the  class!  |t’s  easier  public  static  void  Main  (string  [  ]  args)  { 

to  read  your  Code  if  strin9  result  =  ""; 

thev're  at  the  top,  Nose  [  ]  1  =  new  Nose  [  3] ; 

'  ■  n  i 1  i(0]  =  new  Acts(); 

i [1]  =  new  Clowns () 
i [2]  =  new  Of76 ( ) ; 
for  (int  x  =  0;  x  <  3;  x++)  { 

result  +=  (  .M,EqnQ . +  "  " 

+  ifxj.Face  )  + 

1  ,  . ^ 

Face  is  a  get  accessor  that 

returns  the  value  of  the 

face  Property.  Both  of  then, 

are  defined  in  Picasso  and 

inherited  into  the  subclasses 


\n" 


MessageBox. Show (result) ; 


} 


) 
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8  enums  and  collections 


4- 

#  Storing  lots  of  data  + 


When  it  rains,  it  pours. 

In  the  real  world,  you  don't  get  to  handle  your  data  in  tiny  little  bits  and 
pieces  No,  your  data's  going  to  come  at  you  in  loads,  piles,  and  bunches 
You'll  need  some  pretty  powerful  tools  to  organize  all  of  it,  and  that’s  where 
collections  come  in  They  let  you  store,  sort,  and  manage  all  the  data  that 
your  programs  need  to  pore  through  That  way  you  can  think  about  wnting 
programs  to  work  with  your  data,  and  let  the  collections  worry  about  keeping 
track  of  it  for  you. 


this  is  a  new  chapter  309 


nurse  sharks  and  carpenter  ants 


Strings  don't  always  work  for 
storing  categories  of  data 

Suppose  you  have  several  worker  bees,  all  represented  by 
Worker  classes.  How  would  you  write  a  constructor  that  took 
a  job  as  a  parameter?  If  you  use  a  string  for  the  job  name,  you 
might  end  up  with  code  that  looks  like  this: 


Our  bee  management  software  kept  track 
of  eatb  worker's  job  usin^  a  string  hke 
"Stn^  Patrol"  or  * Nettar  Collector 


Our  Code  would  allow  these  values  to  be  passed 
in  a  Constructor  even  though  the  proyam  only 
supports  Stin^  Patrol,  Kectar  Collector  and 
other  jobs  that  a  bee  does 


Worker  buzz  =  new  Worker ("Attorney  General"); 
Worker  clover  =  new  Worker ("Dog  Walker"); 
Worker  gladys  =  new  Worker ("Newscaster") ; 


*t»  M  J 


You  could  probably  add  code  to  the  Worker  constructor  to  check  each 
string  and  make  sure  it’s  a  valid  bee  job.  Although,  if  you  add  new  jobs 
that  bees  can  do,  you’ve  got  to  change  this  code  and  recompile  the 
Worker  class.  But  that’s  a  pretty  short-sighted  solution.  W  hat  if  you  have 
other  classes  that  need  to  check  for  the  types  of  worker  bees  they  can  be? 
Now  you’ve  got  to  duplicate  code,  and  that's  a  bad  path  to  go  down. 

What  we  need  is  a  way  to  say,  "Hey,  there  are  only  certain  values  that  are 
allowed  here.”  We  need  to  enumerate  the  values  that  are  okay  to  use. 
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Enums  let  you  enumerate  a  set 
of  valid  values 

Aii  enum  is  a  data  tyjx-  that  only  allows  certain  values  for  that  piece 

of  data.  So  vve  could  define  an  enum  called  Jobs,  and  define  the 

allowed  jobs:  C  the  enu"*- 


The  last  enumerator 
doesn’t  have  -to  end 

with  a  tomma,  tut 

usin^  one  makes  't 
easier  to  rearrange 
them  uS.n^  tut  and 
yaste 


public  enum  Job  { 

NectarCollector , 
StingPatrol , 
HiveMaintenance , 
BabyBeeTutoring , 
EggCare^  « _ 


HoneyManuf acturing , 


d„y  £J„ 

us«d  as  a  Jots  VJ|uf 


Senate  eath  value 
with  a  tomma,  and  en 
the  -whole  thin}  vath  a 
turfy  lw ate 


The  stuff  inside  the  bratkets 
is  tailed  the  enumerator  list, 
and  eath  one  of  them  is  an 
enumerator  The  whole  thin<j 
together  is  tailed  an  enumeration 

4 

But  most  yeoyle  just 
tall  them  enums 


Now;  you  can  reference  these  with  types  like  this: 


This  is  the 
name  of  the 
enum 

J,  ^ —  Lnc 

Worker  nanny  =  new  Worker (Job . EggCare) ; 


the  value 


*■«  *»** 1rrrb"*' 

tpatteyt  Worker. Jobs  as  .ts 

yarameter  tyy« 


Any  other  values  aren’t  allowed.  You  can’t  just  make  up  a  new 
value  for  the  enum.  If  you  do,  the  program  won’t  compile. 


private  void  buttonl_Click (object  sender  EventArgs  e) 

I 

Worker  buzz  =  new  Worker (Jobs . AttorneyGeneral) ; 

1 


& 


‘Jobs'  does  not  contain  a  definition  for 
‘AttorneyGeneral' 


Here’s  the  error  you  yt 
from  the  domyiler 
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names  are  better  than  numbers 


Euuws  let  you  represent  numbers  with  names 

Sometimes  it's  easier  to  work  with  numbers  if  you  have  names  for  them.  You  ran  assign 
numbers  to  the  values  in  an  enum  and  use  the  names  to  refer  to  them.  That  way,  you  don't 
have  bunch  of  unexplained  numbers  floating  around  in  your  code.  Here’s  an  enum  to  keep 
track  of  a  the  scores  for  tricks  at  a  dog  competition.  It's  inside  the  DogCompetition 
class,  so  if  you  want  to  use  it  outside  the  class  you'll  need  to  call  it  DogCompetition . 

TrickScores.  ^  .  .... 

This  is  the  DogCompet-t.on 

' - TndkSdores  enum. 

class  DogCompetition {  ^ 

public  enum  TrickScore  { 

Sit  =  7 , 


These  don't  have 
bo  be  in  an^ 
partidular  order, 
and  you  tan  give 
multiple  names 
■the  sa»e  number 

} 


Beg  =  25, 
Rollover  =  50, 
Fetch  =  10, 
ComeHere  =  5 , 
Speak  =  20, 


Supply  a  ... 

tht  ""*»•  tw 

stands  m  to*-. 


name 


The  (int)  tast  tells  the  domp.ler  to  turn  this  into  the 
number  it  represents  So  sinde  TridkSdroe  Speak  has 
an  inde*  o£  to  2C,  (mOTr.dkSdoreSpeak  turns  it 
into  the  int  value  2-0 


//  code  later"'iITTthe  class 

int  score  =( int^TrickScore . Fetch  *  3; 

Mes  sageBox . Show ( score . ToS tring ( ) )  ; 


MessageBox . Show (TrickScore . ComeHere . ToString ( ) ) 


This  shows  "10“ ,  10  *  l. 

ToStrinOjO  returns 

the  name  in  this 
tase,  "ComeHere  • 


You  can  cast  the  enum  as  a  number  and  do  calculations  with  it,  or  you  can  use  the 
ToString  ( )  method  to  treat  the  name  as  a  string.  If  you  don’t  assign  any  number 
to  a  name,  the  items  in  the  list  will  be  given  index  numbers  by  default.  The  first  item 
w  ill  be  assigned  a  0  value,  the  second  a  1,  etc. 

But  what  happens  if  you  want  to  use  really  big  numbers  for  one  of  the  enumerators? 
The  default  type  for  the  numbers  in  an  enum  is  int,  so  you'll  need  to  specify  the 
type  you  need  using  the  :  operator,  like  this: 


public  enum  TrickScore 
Sit  =  7, 


XT 


You  dan  pul  an  enum  inside 

a  dlass  like  this,  or  >t  tan 
e*ist  on  its  own  ouls.de  o+ 
a  dlass 


long  '  {  ^  This  tells  the  dompiler  to  treat 

values  in  the  TriekSdores  enum 
as  longs,  not  ints. 


Beg  =  25OOO9OOOOO25 

|{  you  tried  to  dompile  this  Code  without  spedifyng  long  as  the  type, 
you  d  get  this  message: 

Cannot  implicitly  convert  type  'long'  to  'int' 
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Use  what  you've  learned  about  enums  to  build  a  class  that  holds  a  playing  card. 


O 

O 


Create  a  new  project  and  add  a  Card  class 

You'll  need  two  public  fields:  Suit  (which  will  either  be  Spades,  Clubs,  Diamonds, 
or  Hearts)  and  Value  (Ace,  Two,  Three  ...  Ten,  Jack,  Queen,  King).  And  yoifll 
need  a  read-only  property,  Name  (‘Ace  of  Spades”,  “Five  of  Diamonds”). 

Use  two  enums  to  define  the  suits  and  values. 

Make  sure  that  ( int)  Card.  Suits .  Spades  is  equal  to  0,  followed  by 
Clubs  (equal  to  1),  Diamonds  (2),  and  Hearts  (3).  Make  die  values  equal  to 
their  face  values:  (int)  Card. Values  .Ace  should  equal  1,  Two  should  lie 
2,  Three  should  be  3,  etc.  Jack  should  equal  1 1,  Queen  should  be  12,  and 
King  should  be  13. 


Card 

Suit 

Value 

Name 


1 


Add  a  property  for  the  name  of  the  card 

Name  should  be  a  read-only  property.  The  get  accessor  should  return  a  string  that  describes  the  card. 
This  code  will  run  in  a  form  that  calls  the  Name  property  from  the  card  class  and  displays  it: 


Card  card  =  new  Card (Card. Suits. Spades, 
string  cardName  =  card. Name; 

The  value  of  cardName  should  be  “Ace  of  Spades”. 


lard. Values. Ace) ; 


'O 


To  «ake  this  work,  your  Card 
/Uss  will  need  3 


Add  a  form  button  that  pops  up  the  name  of  a  random  card 

You  can  get  your  program  to  create  a  card  with  a  random  suit  and  value  by  casting  a  random 
number  between  0  and  3  as  a  Cards  .  Suits  and  another  random  number  between  I  and  13 


as  a  Cards  .Values.  To  do  this,  you  can  take  advantage  of  a  feature  of  the  built-in  Random 
class  that  gives  it  three  different  ways  to  call  its  Next  ( )  method: 

When  you've  got  mover 


■than  one  way  to  call  \ 
a  method,  it's  called  ) 
overloading  More 
that  later... 


O* 


c 


Random  random  =  new  Random ( ) ; 
int  numberBetween0and3  =  random. Next (4) ; 
int  numberBetweenlandl3  =  random. Next (1,  14); 
int  anyRandomlnteger  =  random. Next () ;  \ 

This  tells  Random  to  return  a  value  ai  least  I  but  under 


there  |  are  no 

Dumb  Questions 

Oj  Hold  on  a  second.  When  I  was  typing  in  that  code,  I 
noticed  that  an  IntelliSense  window  popped  up  that  said 
something  about  “3  of  3”  when  I  used  that  Random.Next() 
constructor.  What  was  that  about? 

j\‘.  What  you  saw  was  a  constructor  that  was  overloaded  When 
a  class  has  a  method  that  you  can  call  more  than  one  way,  it's 
called  overloading,  When  you're  using  a  class  with  an  overloaded 
method,  the  IDE  lets  you  know  all  of  the  options  that  you  have.  In 
this  case,  the  Random  dass  has  three  possible  NextQ  methods  As 


soon  as  you  type  “random.Next("  into  the  code  window,  the  IDE  pops 
up  its  IntelliSense  box  that  shows  the  parameters  for  the  different 
overloaded  methods.  The  up  and  down  arrows  next  to  the  "3  of 
3'  let  you  scroll  between  them.  That's  really  useful  when  you’re 
dealing  with  a  method  that  has  dozens  of  overloaded  definitions.  So 
when  you're  doing  it,  make  sure  you  choose  the  right  overloaded 
NextQ  method!  But  don't  worry  too  much  now— we  ll  talk  a  lot  about 
overloading  later  on  in  the  chapter 


[random  .Next  ( 


-  3  ofT5}  mt  Random, Next  (int  min  Value,  mt  maxValue) 
rninValue:  The  inclusive  lower  bound  of  the  random  numl 
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arrays...  who  needs  'em? 


EjteticiSe 
Solution 


A  deck  of  cards  is  a  great  example  of  where  limiting  values  is  important.  Nobody 
wants  to  turn  over  their  cards  and  be  faced  with  a  Joker  of  Clubs,  or  a  13  of 
Hearts.  Here's  how  we  wrote  the  Card  class. 


public  class  Card  { 

public  enum  Suits  | 

Spades,  -v  ^ 

Clubs,  s»  r 

,  f  +irs 
Diamonds,  \ 

„  I  *er, 

Hearts  )  ~ 


Y0**  don't  specify  values,  the 
•first  item  in  tke  list  is  e<p«al  to 
«ro,  tke  second  .s  I,  tke  third  is 
2-,  etc. 


public  enum  Values  ( 

Ace  =  1,  - -  ^ 

Two  =2,  ( 

Three  =  3, 

Four  =  4, 

Five  =  5, 

Six  =  6, 

Seven  =  7, 

Eight  =  8, 

Nine  =  9, 

Ten  =  10, 

Jack  =  11, 

Queen  =  12, 

King  =  13 

public/suitsSsuit; 

publi<\ValuesJValue; 


Here’s  where  we  set  the  value  of 
Card  Values  Ate  to  I- 


public  CardtSuits  suit,  Values  value) 
this. Suit  =  suit; 
this. Value  =  value; 


The  <\et  accessor  for  the  Name  property 

tan  take  advantage  of  the  way  an  em*wS 

ToStrin^O  method  returns  its  name 
Converted  to  a  string 


public  string  Name  { 

get  (  return  Value. ToString  ()  +  "  of  "  +  Suit.ToString  () ;  I  Here’s  where  we  se  th 

1  .s-  Here’s  tke  Code  for  the  button  that  pops  -etfldfe 

\£  up  the  name  of  a  random  card  X  random  number  that  we 

private  void  buttonl_Click  (object  sender,  EventArgs  e)  {  k/  Cast  to  tke  enu 
Random  random  =  new  Random ( ) ; 

Card  card  =  new  Card ( (Card. Suits) random. Next (4) ,  (Card. Values) random. Next (1,  14)); 
MessageBox.Show(card.Name) ; 


£<3st  to  tke  enum. 


314  Chapter  8 


enums  and  collections 


We  could  use  aw  array  to  create  a  deck  of  cards... 

W  hat  if  you  want  to  rreate  a  class  to  represent  a  deck  of  cards?  It  would  need  a 
way  to  keep  track  of  every  card  in  the  deck,  and  it'd  need  to  know  what  order  they 
were  in.  A  Card  array  would  do  the  trick — the  top  card  in  the  deck  would  be  at 
index  0,  the  next  card  at  index  1 ,  etc.  Here’s  a  starting  point — a  Deck  that  starts 
out  with  a  full  deck  of  52  cards. 


public  class  Deck  { 

private  Card[]  cards  =  { 

new  Card (Card. Suits . Spades, 
new  Card (Card . Suits . Spades, 
new  Card (Card. Suits . Spades, 

II  ... 

new  Card  (Card. Suits. Diamonds 
new  Card  (Card. Suits. Diamonds 


Tki, 


decUah 


Card .Values . Ace)  , 
Card .Values . Two)  , 
Card . Values . Three )  , 


all  the 

t  s  jus£  abbreviated 
here  to  save 


spate. 


,  Card. Values. Queen ) , 
,  Card .Values . King)  , 


} 


public  void  PrintCards()  { 

for  (int  i  =  0;  i  <  cards .Length;  i++) 

Console . WriteLine (cards [ i] .ToString ( ) ) ; 

} 


...  but  what  if  you  wanted  to  do  more? 

Think  of  everything  you  might  need  to  do  with  a  deck  of  cards,  though.  If 
you’re  playing  a  card  game,  you  routinely  need  to  change  the  order  of  the 
cards,  and  add  and  remove  cards  from  the  deck.  You  just  can’t  do  that  with 
an  array  very  easily, 


How  would  you  add  a  ShuffleQ  method  to  the  Deck  class  that  rearranges 
the  cards  in  random  order?  What  about  a  method  to  deal  the  first  card 
off  the  top  of  the  deck?  How  would  you  add  a  card  to  the  deck? 


you  are  here  ► 
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fine  collectibles 


Arrays  are  hard  to  work  with 


An  array  is  fine  for  storing  a  fixed  list  of  values  or  references.  But  once  you  need 
to  move  array  elements  around,  or  add  more  elements  than  the  array  can  hold, 
things  start  to  get  a  little  sticky. 


Every  array  has  a  length,  and  you  need  to  know  the  length  to  work  with  it.  You  could  use 
null  references  to  keep  some  array  elements  empty: 


This  array 
but  i-t’s  or 


has  a  Length  of  h 


i*”" 5'  +■  % 

+.*f  “HI 

“*?"  Wd 


so 


tards. 


*9  any 


You’d  need  to  keep  track  of  how  many  cards  are  being  held.  So  you’d  need  an  ini  field, 
which  we  could  call  topCard,  which  would  hold  the  index  of  the  last  card  in  the  array.  So 
our  3-card  array  would  havea  Length  of  7,  but  we’d  set  topCard  equal  to  3. 

We  II  add  a  -topCard  -field  to  keep 
track  of  how  many  cards  are  in  the 
array.  Any  mde*  above  topCard  has  a 
null  Card  reference 


HGE131 


01  1  1  ^  There’s  actually  an  /WayRes.wO 

method  Wilt  '"to  the  KtT 
Framework  that  does  exactly  that 

But  now  things  get  complicated.  It’s  easy  enough  to  add  a  PeekQ  method  that  just  returns  a 
reference  to  the  top  card — so  you  can  peek  at  the  top  of  the  deck.  But  what  if  you  want  to  add 
a  card?  If  topCard  is  less  than  the  array’s  Length,  you  can  just  put  your  card  in  the  array  at  that 
index  and  add  I  to  topCard.  But  if  it  the  array’s  full,  you’ll  need  to  create  a  new,  bigger  array 
and  copy  the  existing  cards  to  it.  Removing  a  card  is  easy  enough  but  after  you  subtract  I  front 
toCard,  you’ll  need  to  make  sure  to  set  the  removed  card’s  array  index  back  to  null.  And  what  if 
you  need  to  remove  a  card  from  the  middle  of  the  list?  If  you  remove  card  #4,  you'll  need  to 
move  card  5  back  to  replace  it.  and  then  move  6  back,  then  7  back... wow,  what  a  mess! 
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lists  wake  it  easy  to  store  collections  of...  anything 


The  .NET  Framework  has  a  bunch  of  collection  classes  that  handle  all  of  those 
nasty  issues  that  come  up  with  you  add  and  remove  array  elements.  The  most 
common  sort  of  collection  is  a  List.  Once  you  creat  a  List  object,  it's  easy  to  add 
an  item,  remove  one  from  any  location  in  the  list,  peek  at  an  item,  and  even  move 
an  item  from  one  place  in  the  list  to  another.  Here’s  how  a  list  works: 


First  you  create  new  instance  of  List 

Every  array  has  a  type — you  don't  just  have  an  array,  you  have  an  int  array;  a  Card  array, 
etc.  Lists  are  the  same  way.  You  need  to  specify  the  type  of  object  or  value  that  the  list 
will  hold  by  putting  it  in  angle  brackets  <>  when  you  use  the  new  keyword  to  create  it. 

List  cards  =  new  List<Card> () ; 


You  specified  <Card>  when  you 
Created  the  list,  so  now  this 
list  only  holds  references  to 
Card  objects 


Now  you  can  add  to  your  List 

Once  you’ve  got  a  List  object,  you  can  add  as  many  items  to  it  as  you  want  (as  long  as 
they  match  whatever  type  you  specified  when  you  created  your  new  List). 


cards .Add (new  Card (Card. Suits . Diamonds,  Card. Values. King) ; 


cards. Add (new  Card (Card. Suits .Clubs,  Card. Values. Three) ; 
cards .Add (new  Card (Card. Suits .Hearts,  Card. Values. Ace) ; 


You  can  add  as  many  _ 1 

cards  as  you  want  to  '  ■ — 

the  List  —  just  call  its 
AddO  method  It’ll  make 
sure  it’s  Jot  enoujh 
"slots”  for  the  items.  If 
it  starts  to  run  out,  it’ll 
automatically  resize  itself- 


A  list  keeps  its  elements 
in  order,  just  like  an 
array  fiinj  of  Diamonds 
is  first  1  of  Clubs 
is  second,  and  A Ce  of 
Hearts  is  third^^ 
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wow,  what  an  improvement! 


Lists  are  wore  flexible  than  arrays 


The  List  class  is  built  into  the  .NET  Framework,  and  it  lets  you  do  a  lot  of 
things  with  objects  that  you  can’t  do  with  a  plain  old  array.  Check  out  some 
of  the  tilings  you  can  do  w  ith  a  List. 

You  can  make  one. 

List<Egg>  myCarton  =  new  List<Egg>(); 


Add  something  to  it. 

Egg  x  =  new  Egg ( ) ; 
myCarton.Add(x) ; 


f,  O* 

* 


Now  the  List  e*?a*ds  to  hold 
the  object- 


Add  something  else  to  it. 

Egg  y  =  new  Egg ( ) ; 

myCarton .Add (y) ; 


Find  out  how  many  things  are  in  it. 

int  theSize  =  myCarton .Count; 


,***  to  h0|d 

the  second  Egg  object.. 


Find  out  if  it  has  something  in  particular  in  it. 

bool  Isin  =  myCarton. Contains (x) ; 


p?  r*  ** «•  a*  Jiu 

deh’'<tel y  come  back  true 


Figure  out  where  that  thing  is. 

int  idx  =  myCarton. I ndexOf  (y) ; 


The  index  -for  x  would  be  0  and  the 
.index  (or  y  would  be  I. 


Find  out  how  much  the  list  will  hold. 

int  limit  =  myCarton . Capacity; 


Take  something  out  if  it. 

myCarton . Remove ( y ) ; 


0 


This  will  tell  you  the  number  o( 

'  objects  the  list  can  hold  be -fore  it 
has  to  reside  itself 

poof!  * — 

X/v\ 

tVhen  we  removed  y,  we  left  only 
the  List  so  it  shrank^ 
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Sharpen  your  pencil 


Assume  -these  statements  are  all 
e*etuted  *n  order,  one  after  another 

l  ...  We  -filled  in 

4  List 


Fill  in  the  rest  of  the  table  below  by  looking  at  the  List  code  on 
the  left  and  putting  in  what  you  think  the  code  might  be  if  it  were 
using  a  regular  array  instead.  We  don't  expect  you  to  get  all  of 
them  exactly  right,  so  just  make  your  best  guess. 


Couple  for 


you 


I, 


regular  array 


List<String>  myList  = 

new  List  <String>(); 

String  □  myList  —  new  £trm<jCZ3; 

String  a  =  "Yay!"; 

String  a  —  "Yay!", 

myList .Add (a)  ; 

String  b  =  "Bummer"; 

String  b  —  "Bummer”; 

myList . Add (b) ; 

object  o  =  myList [1]; 

int  theSize  =  myList .Count; 

bool  isln  =  myList .Contains (b) ; 

Hint  You’ll  need  than  more  than^^ 
one  line  of  tode  here  v— 
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one  size  fits  all 


Your  job  was  to  fill  in  the  rest  of  the  table  below  by  looking  at  the  List 
code  on  the  left  and  putting  in  what  you  think  the  code  might  be  if  it 
were  using  a  regular  array  instead. 


list  regular  array 


List<String>  myList  = 

new  List  <String>(); 

String!]  myList  =  new  String [2]; 

String  a  =  "Yay!" 

y!"; 

myList .Add (a) ; 

myListCOJ  —  a, 

String  b  =  "Bummer"; 

String  b  =  "Bummer"; 

myList .Add (b) ; 

myList  Cl]  —  b; 

int  theSize  =  myList .Count; 

int  theSize  —  myList  Length, 

object  o  =  myList [1]; 

object  o  —  myListll  J, 

bool  isln  =  myList. Contains (b) ; 

bool  is|n  —  -false, 

-for  (int  i  —  O',  i  <  myList 

Length;  i++)  { 
if  (b  —  myListfiJ)  { 
is|n  —  true; 

} 

} 

f  f 


Lists  are  objects  that  use  methods  just  like  every 
other  class  you’ve  used  so  far.  You  can  see  the  list 
of  methods  available  from  within  the  IDE  just 
by  typing  a  .  next  to  the  List  name  and  you  pass 
parameters  to  them  just  the  same  as  you  would  for 
a  class  you  created  yourself. 


With  arrays  you’re  a  lot  more  limited.  You  need 
to  set  the  size  of  the  array  when  you  create  it,  and 
any  logic  that’ll  need  to  be  performed  on  it  will 
need  to  be  written  on  your  own. 

t 

The  -NET  Framework  does  have  an 
Array  class  which  makes  some  o-f  these 
things  a  little  easier  to  do.-  but  we  re 
Concentrating  on  List  objects  because 
they're  a  lot  easier  to  use- 
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Lists  shrink  and  grow  dynamically 

The  great  tiling  about  a  List  is  that  you  don’t  need  to  know  howr  long  it'll 
be  when  you  create  it.  A  List  automatically  grows  and  shrinks  to  lit  its 
contents.  Here’s  an  example  of  a  lew  of  the  methods  that  make  working 
w  ith  1  .ists  a  lot  easier  than  arrays: 


List<Shoe>  shoeCloset  =  new  List<Shoe> ( ) ;  * 

Y 'o 

shoeCloset. Add (new  Shoe()  th 

{  Style  =  Style. Sneakers,  Color  =  "Black"  )); 
shoeCloset .Add (new  Shoe() 

(  Style  =  Style. Clogs,  Color  =  "Brown"  >); 
shoeCloset .Add (new  Shoe() 

(  Style  =  Style. Wingtips,  Color  =  "Black"  )); 
shoeCloset . Add ( new  Shoe ( ) 

(  Style  =  Style. Loafers,  Color  =  "White"  )); 
shoeCloset .Add (new  Shoe() 

{  Style  =  Style. Loafers,  Color  =  "Red"  }); 
shoeCloset .Add (new  Shoe() 

(  Style  =  Style. Sneakers,  Color  =  "Green"  1); 

^^-'This  returns  the 
1  i.i  i  r 


>  L,*t 


int  numberOfShoes  =  shoeCloset. Count; 
Goreach (Shoe  shoe  in  shoeCloseTp  ( 


shoe. Style  =  Style. Flipf lops; 
shoe. Color  =  "Orange"; 


total  number  of 
Shoe  objects  in 
the  List- 


T Ke  RemoveO  method  will 
remove  the  object  by  it’s  - 
reference,  Remove^tO  does 
it  by  index  number. 

shoeCloset . RemoveAt ( 4 ) ; 


Shoe  thirdShoe  =  shoeCloset [3] 
Shoe  fifthShoe  =  shoeCloset [5] 
shoeCloset . Clear ( ) ;  - 


shoeCloset .Add (thirdShoe) ; 


This  foreach  looy  ^oes 
through  each  of  the 
shoes  in  the  closet- 


The  ClearO  method 
removes  all  of  the 
objects  in  a  List 

vVe  saved  references 
to  two  shoes  before 
/  we  cleared  the  hst  We 
added  one  back,  but 


if  (shoeCloset  .Contains  (fifthShoe) )  the  other  s  still  missing 
✓ — ^Console. WriteLine ("That' s  surprising. ")  ; 

V-This  line  will  never  run,  because  ContainsO  will  return  false  We 
only  added  thirdShoe  into  the  cleared  list,  not  fifthShoe 


can  use  a  new  statement  inside 
:  List  AddO  method 

foreach  is  special  kind  of 
loop  for  Lists.  It  will  execute 
a  statment  for  each  object 
in  the  List.  This  loop  creates 
an  identifier  called  shoe.  As 
the  loop  goes  through  the 
items,  it  sets  shoe  equal  to 
the  first  item  in  the  list,  then 
the  second,  then  the  third, 
until  the  loop  is  done. 

foreach  loops  work  on  arrays,  W  In 
fact,  they  work  on  any  Collection 

Here’s  the  Shoe  class 
we’re  usiiyy  \ 

- * - k 

public  class  Shoe  {  I 

public  Style  Style; 
public  string  Color; 


public  enum  Style  { 
Sneakers, 
Loafers, 
Sandals, 

Flipf lops, 
Wingtips, 

Clogs, 
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List  objects  can  store  any.  type 


You’ve  already  seen  that  a  I  ,isl  can  store  strings  or  Shoes.  You 
could  also  make  Lists  of  integers,  or  any  other  object  you 
can  create.  That  makes  a  List  a  generic  collection.  When 
you  create  a  new  List  object,  you  tie  it  to  a  specific  type:  you 
can  have  a  list  of  ints,  or  strings,  or  Shoe  objects.  That  makes 
working  with  1  jsts  easy  once  you’ve  created  your  list,  you 
always  know  the  type  of  data  that’s  inside  it. 


BULLET  POINTS 


This  doesn’t  actually  mean  that  you  add  the  letter  T  It's 
notation  that  you’ll  see  whenever  a  class  or  interface  works 
with  all  types  The  <T>  part  means  you  can  put  a  type  in 
there,  like  List<Shoe>,  and  limit  the  type 


List  name  =  new  List<T>() ; 

1 

.  .  .  ,,  l,  ,,U>er  very  flexible  (allowm^  any 

dTand  then  «v*ite  a  few  th.n5s  more- 


The  .NET  Framework  comes  with  some  generic- 
interlaces  that  let  the  collections  you’re  building  work 
with  any  and  all  types.  List  implements  those  interfaces 
and  that’s  why  you  could  create  a  List  of  integers  and 
work  with  it  using  pretty  much  the  same  way  that  you 
would  work  with  a  List  of  Shoe  objects. 

*■  Check  it  out  for  yourself.  Type  the  word,  List, 
into  the  IDE  and  then  right-click  on  it  and  select  “Go 
To  Definition”.  That  will  take  you  to  the  declaration 
for  the  List  class.  It  implements  a  few  interlaces: 


This  is  where  Rem ©veA-fcO,  In dexflfO,  and 
Inser-fcO  Come  from. 


use 


t 

public  class  List<T>  :  (TListcT^P 

C(|Collection<T?^  CEnumerablecf^  IList, 
ICollection,  IEnumerable  ^ 

Dus  is  where  AddO,  ClearO,  TV'S  ^ 

CopyToO,  and  RemoveO  Wcach  oth 

Come  from.  H's  the  basis 
for  all  generic  ColleC-tions. 


■  List  is  a  class  in  the  .NET  Framework. 

■  A  List  resizes  dynamically  to  whatever  size 
is  needed  It  s  got  a  certain  capacity— once 
you  add  enough  data  to  the  list,  it'll  grow  to 
accommodate  it. 

■  To  put  something  into  an  List,  use  Add().  To 
remove  something  from  a  List,  use  Removed. 

■  You  can  remove  objects  using  their  index 
number  using  RemoveAt(). 

■  You  declare  the  type  of  the  List  using  a  type 
parameter,  which  is  a  type  name  in  angle 
brackets.  Example:  List<Frog>  means  the  List 
will  be  able  to  hold  only  objects  of  type  Frog. 

■  To  find  out  where  something  is  (and  if  it  is)  in 
a  List,  use  lndexOf(). 

■  To  get  the  number  of  elements  in  a  List,  use 
the  count  property. 

■  You  can  use  the  Contains!)  method  to  find 
out  if  a  particular  object  is  in  a  List. 

■  foreach  is  a  special  kind  of  loop  that  will 
iterate  through  all  of  the  elements  in  a  list  and 
execute  code  on  it.  The  syntax  for  a  foreach 
loop  IS  foreach  (string  s  in  StringList).  You 
don't  have  to  tell  the  foreach  loop  to  increment 
by  one:  it  will  go  through  the  entire  list  all  on 
its  own. 
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Code  Magnets 


private  void  buttonl_Click (object  sender 


EventArgs  e) { 


Can  you  reconstruct  the  code  snippets  to  make 
a  working  Windows  Form  that  will  pop  up  the 
message  box  below  when  you  click  a  button? 


a . RemoveAt (2) ; 


List<string>  a  =  new  List<string> ( ) 


public  void  printL  (List<string>  a) ( 


if  (a . contains ("two  ))  \  | 

a. Add (twopointtwo) ; 


a.  Add  (fir  st)  ; 
a. Add (second) ; 
a. Add (third) ; 


if  (a. Contains ("three") ) { 
a .Add ("four")  ; 


°reach  (string  element  in  “ 
result  ♦.  »\n"  +  element: 


MessageBox . Show (result) 


if  (a.IndexOf (" foui 
a. Add (fourth) 


’iintL(a) 


string  zilch  =  "zero"; 
string  first  =  "one"; 
string  second  =  "two"; 
string  third  =  "three"; 
string  fourth  =  "4.2"; 
string  twopointtwo  =  "2.2"; 
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Code  Magnets  Solution 


private  void  buttonl_Click (object  sender, 
EventArgs  e) { 


zero 

one 

three 

four 

4.2 

OK 

□ 

1 _ 1 

RemoveAtO  removes 
■the  element,  at 
mde*  — which  is 

the  third  element  in 
the  list 


The  foreach  loop  joes 
through  dll  of  the 
elements  in  the  list 
and  prints  them- 


List<string>  a  =  new  List<string> ( ) ; 


string  zilch  =  "zero"; 
string  first  =  "one"; 
string  second  =  "two"; 
string  third  =  "three"; 
string  fourth  =  "4.2"; 
string  twopointtwo  =  "2.2"; 


a.  Add  (first)  ; 
a. Add (second) ; 

a. Add (third) ;  _ 

if  (a. Contains ("three") ) { 
a. Add ("four")  ; 

) 


a.RemoveAt (2) ;  | 

if  (a. IndexOf ("four")  !=  4)  {  B 
a .Add (fourth) ; 

} 


i 

Can  you  -figure 
<*t  why  “2.2" 
wer  Jets  added 
t°  the  list,  even 
though  it’s 
declared  here? 


a. Add (twopointtwo) ; 


The  printt-0  method  uses  a 
foreach  loop  to  go  through  a 
list  of  strings,  add  each  of 
them  to  one  big  string,  and 
then  show  it  in  a  message  bo* 


public  void  printL  (List<string> 

'SI ' : : 

foreach  (string  element 
result  +=  «\n 


{ 


in  a) 

I  ...  +  element; 

— ^ - 

MessageBox . Show (result) ; 
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o 

'V;  So  why  would  I  ever  use  an  enum 
instead  of  a  List?  Don't  they  solve  the 
same  problem? 

Enums  are  a  little  different  than  Lists. 
You  can  think  of  enums  as  a  handy  way  to 
store  lists  of  constants  so  you  can  refer 
to  them  by  name.  They're  great  for  keeping 
your  code  readable  and  making  sure  that 
you  are  always  using  the  right  variable 
names  to  access  values  that  you  use  really 
frequently. 

A  List  can  store  just  about  anything.  Since 
its  a  list  of  objects,  each  element  in  a  list 
can  have  its  own  methods  and  properties. 
Enums,  on  the  other  hand,  have  to  be 
assigned  one  of  the  value  types  in  C#  (like 
the  ones  on  the  first  page  of  Chapter  4).  So, 
you  can't  store  reference  variables  in  them. 

Enums  can’t  dynamically  change  their  size 
either.  They  can't  implement  interfaces  or 
have  methods,  and  you’ll  have  to  cast  them 
to  another  type  to  store  a  value  from  an 
enum  in  another  variable  Add  all  of  that  up 
and  you've  got  some  pretty  big  differences 
between  the  two  ways  of  storing  data  But 
both  are  really  useful  in  their  own  right. 

Qj  OK,  it  sounds  like  Lists  are  pretty 
powerful.  So  why  would  I  ever  want  to 
use  an  array? 

Arrays  take  up  less  memory  and 
take  less  CPU  time  for  your  programs. 

If  you're  doing  something  that's  really 
performance-intensive— like  the  same 
operation  thousands  and  thousands  of 


Okay,  honestly,  weVe  talking 
about  a  really,  really  tiny 
performance  boost  Like  if 
you  have  to  do  the  same  thing 
millions  of  times  a  seCond,  use 
an  array  and  not  a  list 


tlierejare  np 

Dumb  Questions 


times  -then  you  might  find  that  a  List 
will  cause  your  program  to  slow  down 
significantly.  Luckily,  you  can  easily  convert 
any  list  to  an  array  using  the  ToArray  ( ) 
method...  and  you  can  convert  an  array  to  a 
list  using  one  of  the  overloaded  constructors 
for  the  List  object. 

o 

I  don’t  get  the  name  "generic".  Why 
is  it  called  a  generic  collection?  Why  isn't 
an  array  one? 

A  generic  collection  is  a  collection 
object  (or  a  built-in  object  that  lets  you  store 
and  manage  a  bunch  of  other  objects)  that’s 
been  set  up  to  store  only  one  type. 

o 

Okay,  that  explains  the  “collection” 
part.  But  what  makes  it  “generic”? 

Supermarkets  used  to  carry  generic 
items  that  were  packaged  in  big  white 
packages  with  black  type  that  just  said  the 
name  of  what  was  inside  (“Potato  Chips”, 
‘Cota”,  “Soap”,  etc.).  The  generic  brand  was 
all  about  what's  inside  the  bag,  and  not 
about  how  it's  displayed. 

The  same  thing  happens  with  generic  data 
types  Your  List<>  will  work  exactly  the  same 
with  whatever  happens  to  be  inside  it.  A  List 
of  Shoe  objects,  Card  objects,  ints,  longs,  or 


Qj  Can  I  have  a  list  that  doesn't  have 
a  type? 

No  Every  list— in  fact,  every  generic 
collection  (and  you'll  learn  about  the  other 
generic  collections  in  just  a  minute)— must 
have  a  type  connected  to  it.  C#  does  have 
non-generic  lists  called  ArrayLists  that  can 
store  any  kind  of  object.  If  you  want  to  use 
an  ArrayList,  you  need  to  include  a  “using 
System. Collections;”  line  in 
your  code. 

Generic  collections  are  actually  a  recent 
addition  to  C#— they  didn’t  exist  in  the  early 
versions  of  the  language.  But  they're  so 
useful  that  people  rarely  use  non-generic 
collections  any  more...  which  is  why  we 
won’t  be  talking  much  about  them. 

When  you  create 
a  new  List  object, 
you  always  supply 
a  type— tkat  tells 
C#  wkat  type 
of  data  tkat  it’ll 


even  other  Lists  will  still  act  at  the  container 
level  So  you  can  always  add,  remove,  insert 
etc.,  no  matter  what's  inside  the  list  itself,  f 


store.  A  list  can 

,  no  matter  what's  inside  the  list  itself.  ft 

TKe  I*- m  "generic”  refers  {*  the  J  store  a  value  type 

fact  that  even  though  a  specif  id  _  j  . 

instance  of  List  can  only  store  UlKC  Hit,  bOOl,  Or 

one  specific  type,  the  List  class  in  . 

general  works  with  any  type  string)  Or  a  claSS. 

That’s  what  the  <T>  stuff  is  all  about  It's  the  way  thatyou 
tie  a  specific  instance  of  a  List  to  one  tyve^But  the  List  class 
as  a  whole  is  generic  enough  to  work  with  ANY  type  Thats  why 
generic  Collections  are  different  from  anything  you  ve  seen  so  tar. 
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initial  here 


Collection  initializers  work  just  like  object  initializers 


C#  gives  you  a  nice  hit  of  shorthand  to  cut  down  on  typing  when  you  need  to 
create  a  list  and  immediately  add  a  bunch  of  items  to  it.  When  you  create  a 
new  List  object,  you  can  use  a  collection  initializer  to  give  it  a  starting  list  of 

items.  It'll  add  them  as  soon  as  the  list  is  created.  . 

you  saw  this  Code  a  -few 

pages  ago-it  creates  a  new 
List<£hoe>  and  -fills  it  with 
new  Shoe  objects 


•T 


List<Shoe>  shoeCloset  =  new  List<Shoe> () ; 


shoeCloset .Add(new  Shoe() 
shoeCloset .Add (new  Shoe() 
shoeCloset .Add (new  Shoe() 
shoeCloset .Add (new  Shoe() 
shoeCloset .Add (new  Shoe() 
shoeCloset . Add ( new  Shoe  ( ) 

& 

s? 

Collefrtion  Initializers  are  a 
C#  3.0  -feature  It  you're  still 
using  Visual  Studio  2-001?,  you 
should  download  Visual  Studio 
2-000  Express  tor  tree  t  rom 
Microsoft,  otherwise  this  Code 
won  t  work- 


{  Style  =  Style . Sneakers,  Color  =  "Black"  }); 
(  Style  =  Style. Clogs,  Color  =  "Brown"  }); 

(  Style  =  Style. Wingtips,  Color  =  "Black"  }) ; 
{  Style  =  Style . Loaf ers ,  Color  =  "White"  }); 

(  Style  =  Style . Loaf ers ,  Color  =  "Red"  }); 

(  Style  =  Style . Sneakers,  Color  =  "Green"  }); 


You  can  create  a  Collection 
initializer  by  taking  each  item 
that  was  being  added  using 
AddO  and  adding  them  to  the 
statement  that  creates  the  list 


List<Shoe>  shoeCloset  =  new  List<Shoe>()  { 


the  list  is  followed  by 
Curly  brackets  that  / 


Contain  separate  new 


* 


You’re  not  limited  to 
using  new  statements  ^ 
in  the  initialize*-— you 
Can  include  variables, 
too 


new 

Shoe ( ) 

{ 

Style 

= 

Style . Sneakers 

,  Color 

=  "Black" 

>, 

new 

Shoe ( ) 

{ 

Style 

= 

Style. Clogs,  Color  =  " 

Brown"  } , 

new 

Shoe ( ) 

{ 

Style 

= 

Style . Wingtips 

,  Color 

=  "Black" 

) , 

new 

Shoe ( ) 

{ 

Style 

= 

Style . Loafers , 

Color  = 

i  "White"  } 

/ 

new 

Shoe ( ) 

{ 

Style 

= 

Style . Loafers , 

Color  = 

:  "Red"  }, 

new 

Shoe ( ) 

{ 

Style 

= 

Style . Sneakers 

,  Color 

=  "Green" 

>, 

A  collection  initializer  makes  your  code  more 
compact  by  letting  you  combine  creating  a  list 
witb  adding  an  initial  set  of  items. 
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Let's  create  a  list  of  Pucks 


Here’s  a  duck  rlass  that  keeps  track  of  your  extensive  duck 
colleciton.  (You  do  collect  ducks,  don’t  you?) 


Each  duCk  has  a  six/— -this 


you’ve  jot  some 
Muscovy  ducks 


f\rA  you’ve  jot  a  fc* 
wood  detoys  ^ 


Duck 

Size 

Kind 


Quack() 

Swim() 

Eat() 

Walki) 


\ 


public  class  Duck  { 


public  int  Size; 


public  KindOfDuck  Kind; 


} 


The  class  has  two  public 
■fields  It's  also  jot  some 
methods,  which  weVe  not 
showinj  here. 


Here's  the  initializer 

We’ve  got  six  ducks,  so  we’ll  create  a  List<Duck>  that  has 
a  collection  initializer  with  six  statements.  Each  statement 
in  the  initializer  creates  a  new  duck,  using  an  object 
initializer  to  set  each  Duck  object’s  Size  and  Kind  field. 


public  enum  KindOfDuck  { 
Mallard, 

Muscovy, 

Decoy 

1 

We'll  use  a«  enum 
called  KindOfDuck  to 


List<Duck>  Ducks  =  new  List<Duck>()  { 

KindOfDuck. Mallard,  Size 


new 

Duck  () 

{ 

Kind 

new 

Duck ( ) 

{ 

Kind 

new 

Duck ( ) 

{ 

Kind 

new 

Duck  () 

{ 

Kind 

new 

Duck  () 

I 

Kind 

new 

Duck ( ) 

{ 

Kind 

17 


keep  track  of  what 
sort  of  ducks  are  in 
you r  Collection 


}; 
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getting  your  ducks  in  a  row 


lists  are  easy,  but  SORTING  caw  be  tricky 

It's  not  hard  to  think  about  ways  to  sort  numbers  or  letters.  But  what  do  you 
sort  two  objects  on,  especially  if  they  have  multiple  fields?  In  some  cases  you 
might  want  to  order  objects  by  the  value  in  a  name  field,  while  in  other  cases 
it  might  make  sense  to  order  objects  based  on  height  or  date  of  birth.  There 
are  lots  of  ways  you  can  order  things,  and  Lists  support  any  of  them. 


You  could  sort  a  list  of  ducks  by  size...  Sma,les*  k  b*93«t 


.or  by  type. 


lists  know  how  to  sort  themselves 

Every  list  comes  with  a  Sort()  method  that  rearranges  all  of  the  items  in 
the  list  to  put  them  in  order.  Lists  already  know  how  to  sort  most  built-in 
types  and  classes,  and  it's  easy  to  teach  it  how  to  sort  your  own  classes. 
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Two  ways  to  sort  your  ducks 


The  I  .ist.SorlQ  method  already  knows  how  to  sort  any  type  or  class  that  implements 
the  IComparable  interface.  That  interface  has  just  one  member— a  method 
called  Compare ToQ.  Sort0  uses  an  object’s  CompareToQ  method  to  compare  it  with 
other  objects,  and  uses  its  return  value  (tut  int)  to  determine  which  comes  first. 

But  sometimes  you  need  to  sort  a  list  of  objects  that  don't  implement 
IComparable,  and  .NET  has  another  interface  to  help  with  that.  You  can  pass 
SortQ  an  instance  of  a  class  that  implements  IComparer.  That  interface  also 
has  one  method.  The  List’s  SortQ  method  uses  the  comparer  object’s  Compare^) 
method  to  compare  pairs  of  objects,  in  order  to  figure  out  which  one  comes  first  in 
the  sorted  list. 


Aw  object's  CompareToO  method  compares  it 
with  awother  object 

One  way  to  let  our  List  object  sort  is  to  modify  the  Duck  class  to 
implement  IComparable.  To  do  that,  we’d  add  a  CompareToQ 
method  that  takes  a  Duck  reference  as  a  parameter.  If  the  duck 
to  compare  should  come  after  the  current  duck  in  the  sorted  list, 
CompareToQ  returns  a  positive  number. 


You  can  make 
any  class 
work  with  the 
List’s  built-in 
SortO  method 
by  having  it 
implement 
IComparable 


an 


d  addi 


inga 
CompareToO 
method. 


Here’s  a  Duck  class  that  sorts  itself  biased  on  duck  size: 

public  class  Duck  :  IComparable<Duck>  ( 
public  int  Size; 


When  you  implement  IComparable,  you 
speci-fy  the  type  being  compared  when 
you  Have  tbe  class  implement  tbe 
inter-face 


public  KindOfDuck  Kind; 


public  int  CompareTo (Duck  duckToCompare)  { 


Most  CompareToO  methods 
look  a  lot  like  this.  This 
method  first  Compares  the 
Size  field  aga.nst  the  other 
duck's  S «£  held-  It  th.s 
duCk  is  bigger,  it  returns 
ifs  smaller,  it  returns  -I- 

And  it  they’re  the  same  si**, 

it  returns  rero 


(this. Size  >  duckToCompare. Size) 
return  1; 

else  if  (this. Size  <  duckToCompare. Size) 

1  e  11  n  ^  '  |f  you  want  to  sort  your  list  -Prom  smallest 

else  bo  biggest,  have  CompareToO  return  a 

return  0;  positive  number  it  it's  comparing  to  a 

smaller  duck,  and  a  negative  number  it  it's 
Comparing  to  a  bigger  one 
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sort  it  out  amongst  yourselves 


Use  IComparer  to  tell  your  List  how  to  sort 


Lists  have  a  special  interlace  built  into  the  .NET  Framework  that  lets 
you  build  your  own  sorting  logic.  By  implementing  the  IComparer 
interface,  you  are  can  tell  your  List  exactly  how  you  want  it  to  sort 
your  objects.  You  do  that  by  implementing  the  Compare  ( )  method  in 
the  IComparer  interface.  It  takes  two  object  parameters,  x  and  y,  and 
returns  an  int.  If  x  is  less  than  y,  it  should  return  a  negative  value.  If 
they're  equal,  it  should  return  zero.  And  if  x  is  greater  than  y,  it  should 
return  a  positive  value. 

Here’s  an  example  of  how  you’d  declare  a  comparer  class  to  compare 
duck  objects  by  size: 


public  class  DuckComparer  bySize 


Tk.s  class  implements  /Co* 

^  type  of  object  it 
ca*  sort-  Duck  objects. 


{ 


public  int  Compare (Duck  x, 

{ 


tZ  '***»/^ 

yr‘  °f 


Size) 


Size) 


"'fans 


Positive  / 

sh?,d  9o  after 

3’ne^er"  tka 


IComparer<Duck> 

^ _ _ '  .  these  will  always  match; 

duc^TT — ^ ihe  ia"e  ^  ih 

-» 

n  „ethod  returns  3rv 

The  Co«'?d're  both 

oUhct^  you  resorts 

f\  _|  means  object  *  should 
9o  before  object  y^  *  ,s  l£SS 
°hject  x  than”  y. 

°fcj«t  y.  x 


tomyaoson  calculation 


Your  List  will 
sort  differently 
depending  on  kow 
you  implement 
IComparer. 
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Create  an  instance  of  your  comparer  object 

When  you  want  to  sort  using  IComparer,  you  need  to  create  a  new 
instance  of  the  class  that  implements  it.  That  object  exists  for  one 
reason — to  help  List.SortO  figure  out  how  to  sort  the  array.  But  like  any 
other  (non-static)  class,  you  need  to  instantiate  it  before  you  use  it. 

List<Duck>  ducks  =  new  List<Duck>()  {  ...  }; 
DuckComparer_bySize  dc  =  new  DuckComparer  bySize (); 


We  left  out  the  code  you  already 
saw  a  few  pa$es  350  to  mit»ali« 

■  the  list 


ducks . Sort (dc) ; 

T 

s/ou'll  pass  Sort 0  a  reference  to  the 
new  puckCo»»farer_bySi«  object  as 
its  parameter. 


Sorted  smallest  to  b.jgest .. 


Multiple  IComparer  implementations,  multiple  ways  to 
sort  your  objects 

You  can  create  multiple  IComparer  ckisses  with  different  sorting  logic 
depending  on  what  you  need  to  do.  Then  you  can  call  the  comparer  you 
want  when  you  need  to  sort  in  that  particular  way.  Here’s  another  duck 
comparer  implementation: 

y' 

class  DuckComparer_byKind  :  IComparer<Duck>  { 
public  int  Compare (Duck  x.  Duck  y)  { 
if  (x.Kind  <  y.Kind) 

return  -1;  _. 

if  (x.Kind  >  y.Kind)  We  used  the  valw 

return  1;  ^ —  that  Comes  from 

else  1  the  enum  PuCk T 

return  0;  , 

i  _ _ c Jr ’“f  lr  v»t»  ^ 


9  ualufs.  . 


LI 


^  We  used  the  value  of  the  Type 

that  Comes  from  the  inde*  value  >n 

tw  «.  P-K-Tyn-  ,  «***££'.  t— 

w  3„d  ^  C  ** 

ordering  **  use 


DuckComparer_byKind  dcKind  =  new  DuckComparer_byKind () ; 
ducks . Sort (dcKind) ; 

_ Sorted  by  kind  of  duck 


you  are  here  ► 
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pick  a  card  any  card 


IComparer  can  do  complex  comparisons 

One  advantage  to  creating  a  separate  class  for  sorting  your  clucks  is 
that  you  can  build  more  complex  logic  into  that  class — and  you  can 
add  members  that  help  determine  how  the  list  gets  sorted. 

public  class  DuckCoraparer  :  IComparer<Duck>  { 
public  enum  SortCriteria  { 

SizeThenKind, 

KindThenSize,  '  ^IS  ehwn'  tells  ■the  object  which 
}  to  sort  the  ducks 


public  SortCriteria  SortBy  =  SortCriteria. SizeThenKind; 


Here's  a  more  Couple*  class  to 
Compare  dudes  It*  CowfareToO 
method  takes  the  same  parameters, 
but  it  looks  at  the  public  SortBy 
-field  to  determine  how  to  sort  the 
ducks 


1 


DuckComparer  dc  =  new  DuckComparer () 


public  int  Compare (Duck  x,  Duck  y)  { 

if  (SortBy  =  SortCriteria . SizeThenKind) 

if  (x.Size  >  y.Size) 
return  1; 

else  if  (x.Size  <  y.Size) 
return  -1; 

else 

if  (x.Kind  >  y.Kind) 
return  1; 

else  if  (x.Kind  <  y.Kind) 
return  -1; 

else 

return  0; 

else 

if  (x.Kind  >  y.Kind) 
return  1; 

else  if  (x.Kind  <  y.Kind) 
return  -1; 

else 

if  (x.Size  >  y.Size) 
return  1; 

else  if  (x.Size  <  y.Size) 
return  -1; 

else 

return  0; 


na; 

A-  This  if  statement  checks  the  SortBy 
\.  field  If  it’s  set  to  SizeThenKind, 


then  it  first  sorts  the  ducks  by  size, 
and  then  within  each  size  it'll  sort 
the  ducks  by  their  kind 


Instead  of  just  returning  0  if  the  two 
ducks  are  the  same  size,  the  Comparer 
checks  their  kind,  and  only  returns  0 
if  the  two  ducks  are  both  the  same 
size  and  the  same  kind 


|f  SortBy  isn’t  set  to  SizeThenKind, 
then  the  Comparer  f  irst  sorts  by  the 
kmd  of  duck  if  the  two  ducks  are  the 
same  kind,  then  it  Compares  their  size 


if 


dc. SortBy  =  DuckComparer. SortCriteria. KindThenSize; 
ducks . Sort ( ) ; 

dc. SortBy  =  DuckComparer .SortCriteria. SizeThenKind; 
ducks. Sort () ; 


m  «'a  uwaii,  *  rrvjf" 

before  callm5  duCks-SortO-  Kow  you 
thany  the  way 
just  by  chan^in^  one 


can 

the  list  sorts  its  ducks 
f  ield  m  the  object 
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4^ 

O 


Create  five  random  cards  and  then  sort  them. 


Console  jpp|i^oris  ^ 

^"-mand  prompt  use  i,  1  *  ^roin'  the 

r  ”"tk^  a  lot  U  yj£  ^MVntoUoO 

P  JPpl'^tion  too.  y  h  *  '•»  a  Widows 


Create  code  to  make  a  jumbled  set  of  cards 

Add  a  button  to  a  form  that  creates  five  random  Card  objects.  Alter  you  create  each  object,  use  the 
built-in  Console .  WriteLine  ( )  method  to  write  its  name  to  die  output.  You  can  view  everything 
written  to  the  output  by  selecting  “Output"  from  the  View  menu  while  the  program’s  running. 

Create  a  class  that  implements  IComparer<List>  to  sort  the  cards 

Here’s  a  good  chance  to  use  Unit  IDE  shortcut  to  implement  an  interface: 

public  class  CardComparer_byValue  :  IComparer<Card> 

Then  click  on  IComparer  and  hover  over  the  I.  You’ll  see  a  box  appear  underneath  it,  when  you 
click  on  the  box,  the  IDE  pops  up  a  window: 

^Conparer<Card> 

dJ  ”1 


Implement  interface  'IComparer<Card>' 

Expkatly  implement  rterface  'IComparer<Card>' 

If  you  click  on  “Implement  interface  IComparer<Card>”,  the  IDE  automatically  fills  in  all  of  the 
methods  and  properties  that  you  need  to  implement.  In  this  case,  it  creates  an  empty  CompareO 
method  to  compare  two  cards,  x  and  y.  Write  the  method  so  that  it  returns  1  if  x  is  bigger  than  y,  -1 
if  it’s  smaller,  mid  0  if  they're  the  same  card.  In  this  case,  make  sure  that  any  king  comes  after  than 
any  jack,  w  hich  comes  after  than  any  four,  which  comes  after  than  any  ace. 

Make  sure  the  output  looks  right 

Here’s  what  your  output  window'  should  look  like  after  you  click  the  button. 


When  you  use  -the 
buil't —  in  Console. 
WriteLineO  method, 
it  adds  a  line  to  this 
output  window. 


Show  output  from ;  |  Debug 

’  rfBt  X 

Five  random  cards: 

A 

King  of  Clubs 

Jack  or  Clubs 

Three  of  Hearts 

Four  ot  Clubs 

Ten  of  Spades 

Those  same  cards,  sorted: 

Three  ot  Hearts 

Four  of  Clubs 

Ten  of  Spades 

Jacfc  of  Clubs 

King  of  Club3 

V 

< 

> 

3  output  <3  Locals  *3  /vatch  l 

Your  I  Comparer 
object  needs  to  sort 
the  cards  by  value, 
so  the  cards  with 
the  lowest  values  are 
•first  in  the  list 


you  are  here  > 


333 


look  it  up 


EmdSe 

Solution 


Create  five  random  cards  and  then  sort  them.  u  . 

ft**  *  the  Vj»  r  , 

tic  buili-ln  Li stScrtO*  ef+L. Ti'**  us« 

-  ^ ZS,  ^  fate  *. 

IComparer<Card>  {  ^  va,u« 


public  class  CardComparer_byValue 


public  int  Compare (Card  x, 
has  a  bigger  suj^  f  if  (x. Value  <  y. Value) 


I f  x 

/  IfZ**”  \ 

is  smalls  return  ^  ) 
Rcmc* ber,  both  return/  if 


Card  y) 
{ 


statements  eh£| 
method  immediately. 


return  -1; 

(x. Value  > 
return  1; 


y. Value)  ( 


if 

) 

if 


(x.Suit 

return 

(x.Suit 

return 


<  y.Suit) 
-1; 

>  y.Suit) 

1; 


•N  These  statements  only  get 
/  exerted  iW  and  y  have  the 
V,  same  suit— that  means  the 
r  ti«t  ti*  return  statements 
\  weren't  executed 


} 

return  0; 


^  w  kit  ^  urd,  „ust  k 

the  same— so  return  zero 


private  void  buttonl_Click (object  sender,  EventArgs  e) 

( 


') 


Console .WriteLine ("Five  random  cards: 

List<Card>  cards  =  new  List<Card> ( ) ; 
for  (int  i  =  0;  i  <  5;  i++) 

{ 

cards .Add (new  Card( (Card. Suits) random. Next (4) , 

(Card. Values) random. Next (1,  14))). 
Console. WriteLine (cards [i] .Name) ; 


Here's  a  generic  List 
of  Card  objects  to 
store  the  cards  OnCe 
they're  in  the  list,  it’s 
easy  to  sort  them 
using  an  IComparer 


Console. WriteLine ("Those  same  cards,  sorted:"); 
cards . Sort (new  CardComparer_byValue ( ) ) ; 
foreach  (Card  card  in  cards) 

( 

Console. WriteLine (card. Name) ; 

) 
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Use  a  dictionary  to  store  keys  and  values 

A  list  is  like  a  big  long  page  full  of  names.  But  what  if  you  want,  for  each  name,  an 
address?  Or  for  every  car  in  the  garage  list,  you  want  details  about  that  car?  You  need  a 
dictionary.  A  dictionary  lets  you  take  a  special  value — the  key  —and  associate  that  key 
with  a  bunch  of  data  the  value.  And  one  more  thing;  a  specific  key  can  only  appear 
once  in  any  dictionary. 


Dictionary  <Tkey,  TValue>  kv  = 

These  are  like  List<T>.  The  <T>  means 
a  tyye  goes  in  ■there  So  you  tan  declare 
one  tyye  for  the  key)  and  another  tyye 
for  the  value 


new  uiccionary 


- i 


r  y 

The  first  item  in  the  ingle 
brackets  is  always  the  key,  and  the 
second  is  always  the  data 


.And  here’s  a  Dictionary  in  action: 


private  void  buttonl_Click (object  sender,  EventArgs  e) 

{  ^ - -  - -  TK"  Wy  has  sir 


- - -  I? 

Dictionary<string,  string>  wordDef inition 
new  Dictionary<string,  string>(); 


kevs  ltr'h9  VJ,U«  ■for 


The  Md() 
method  is  bow 
you  add  keys 
and  values  to 
the  dictionary 


wordDef  ini  tiori'^dd'^)  "Dictionary" ,  "A  book  that  lists  the  words  of  a  " 

' - "+  "language  in  alphabetical  order  and  gives  their  meaning") ; 

wordDef inition. Add  ("Key",  "A  thing  that  provides  a  means  of  gaining  access  to 


+  "our  understanding  something."); 
wordDef inition. Add  ("Value",  "A  magnitude,  quantity,  or  number."); 


if  (wordDef ini tionCcontainsKey ("Key" )  )]^ 

MessaaeBox  ■  Show  (wordDef  inition  ["Key"] )  ;  y  U)  tells  you  if  3  k Of  ,s  ir 

•  e  „ _ /  'itfA**'-* 

ttt«‘  k"  itta-,  mia-V1 


AddO  takes  a 
key,  and  then 
the  value. 


you  are  here  ► 
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map  anything  to  anything 


The  Actionary  Functionality  Rundown 

Dictionaries  are  a  lot  like  Lists.  Both  types  are  flexible  in  letting  you 
work  with  lots  of  data  types,  and  also  come  with  lots  of  built-in 
functionality.  Here  are  the  basic  Dictionary  methods: 


»  Add  an  item. 

You  can  add  an  item  to  a  dictionary  by  passing  a  key  and  a  value  to  its  the  Add  ( )  method. 

Dictionary<string,  string>  myDictionary  =  new  Dictionary<string,  string>(); 


myDictionary. Add ("some  key",  "some  value"); 

+  Look  up  a  value  using  its  key. 

The  most  important  thing  you'll  do  with  a  dictionary  is  look  up  values — which  makes 
sense,  because  you  stored  those  values  in  a  dictionary  so  you  could  look  them  up  using 
their  unique  keys. 


string  lookupValue  =  myDictionary ["some  key"]; 


+  Remove  an  item. 

Just  like  a  List,  you  can  remove  and  item  from  a  dictionary  using  the  Remove  ()  method. 
All  you  need  to  pass  to  the  Remove  method  is  the  Key  value  to  have  both  the  key  and  the 
value  removed. 


myDictionary . Remove ( " some  key" ) 


*  Get  a  list  of  keys. 


are  un.gue  in  a  Dictionary,  any  key  appears  exactly 
once  \/alues  can  appear  any  number  of  W-two  keys 
can  have  the  same  value-  That  way,  when  you  look  up  or 
remove  a  key,  the  Dictionary  knows  what  to  remove 


You  can  get  a  list  of  all  of  the  keys  in  a  Dictionary  using  a  KeyCol  lection  and  loop 
through  it  using  a  foreach  loop.  You'll  usually  use  a  Keycollection  like  this: 


»  Get  a  list  of  values. 


foreach  (string  key  in  myDictionary . Keys)  {...};  ... 

~/y  Keys  is  a  property  of  your  d-ct-onary  object  This  Particular 

dictionary  has  string  keys,  so  Keys  is  a  collection  of  strings. 


You  can  get  a  list  of  all  of  the  values  in  a  Dictionary  using  a  ValueCollection.  Most  of 
the  time,  you  use  a  ValueCollection  with  a  foreach  loop  too: 


foreach  (string  value  in  myDictionary .Values)  {  . . 

CTWe  this  dictionary  has  string  values,  the 
foreach  identifier  will  be  a  string 


) ; 
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Your  key  and  value  can  be  different  types,  too 


Dictionaries  are  really  versatile  and  can  hold  just  about  anything,  from  strings  ,  ^  (jx  ilinliuii3>  'if  it 

to  numbers  and  even  objects.  Here’s  an  example  of  a  dictionary  that's  storing  txt  s  ,  L  '  , 

i  i  i  i  i  •  .  i  n  u  i  •  . »  dec  ared  t  II  sW  rubers  and 

an  integer  as  a  key  and  a  duck  obiect  as  a  value.  1  he  Duck  object  has  a  ,  '  ..  .  p  ..  ■ 

„ .  5 , ,  .  J  .  J  .  .  ,  .  J  ducks  VVe  11  add  each  of  ike  ducks 

Size  held  and  Types  enum  that  are  set  inside  its  constructor.  ,  ,  .  .  .i  .  .  „ 

^  to  the  dictionary,  j.vinj  it  a  unique 

j  ID  number  as  the  key 

Dictionary<int,  Duck>  duckDictionary  =  new  Dictionary<int,  Duck>() ; 

duckDictionary. Add (5155,  new  Duck()  (  Kind  =  KindOfDuck .Mallard,  Size  =  15  }); 

duckDictionary .Add (625 6,  new  Duck()  (  Kind  =  KindOfDuck .Mallard,  Size  =  14  }); 

duckDictionary .Add (2799,  new  DuckO  (  Kind  =  KindOfDuck .Mallard,  Size  =  13  }); 

- - - The  Count  property  tells 

bow  many  key- value  pairs  are 

int  howMany  =  duckDictionary. Count;  in  the  Dictionary 

Console .WriteLine ("There  are  (0)  ducks.",  howMany); 

If  you  need  to  pull  the  keys  and  .  ^'S 

,il“'s  St*  ^  £a0  i/^  '  w&aL  *  *  *>-* 

I  tL*  tk.  «w«  w 

foreach  (KeyValuePairCint,  Duck>  idDuck  in  duckDictionary) 


Console. WriteLine ("Key /value  pair:  (0):  (1),  (2)", 

idDuck. Key,  idDuck. Value. Size,  idDuck. Value. Kind. ToStringO  ); 


foreach  (Duck  duck  in  duckDictionary .Values) 


he  **  bit  Sniarvalue  Since 

'  CSn  its  -fields. 


Console .WriteLine ("Duck  size:  (0)",  duck. Size); 

-  This  foreach  loop  joes  through  all  of  the 
values  in  the  dictionary- 

foreach  (int  key  in  duckDictionary. Keys) 

Console  .WriteLine  ("ID  Number:  (0)",  key)  ,*>>.  ^nd  this  foreach  loop  pulls  each  of 

-bhe  keys  out  of  the  dictionary 


Show  output  from :  Debug  -  1 

Key/value  pair:  51SS:  IS,  Mallard  a 

Key/value  pair:  62S6:  14,  Mallard 

Key/value  pair:  2799:  13,  Mallard 

Duck  sire:  IS 
Duck  size:  14 
Duck  size:  13 
ID  Number:  5155 
ID  Number:  6256 

ID  Number:  2799  v 


Here  s  the  ou  tput 
that  this  Code 
writes  to  the  Console. 


you  are  here  > 


all  hands  on  deck 


Build  a  form  that  lets  you  move  cards  between  two  decks 

You’ve  built  a  card  class  already.  Now  it's  time  to  build  a  class  to  hold  any  number  of  cards,  which 
we’ll  call  Deck.  A  real-life  deck  has  52  cards,  but  the  Deck  class  can  hold  any  number  of  cards — 
or  no  cards  at  all. 


Then  you’ll  build  a  form  that  shows  you  the  contents  of  two  Deck  objects.  When  you  first  start  the 
program,  deck  #1  has  up  to  10  random  cards,  and  deck  #2  is  a  complete  deck  of  52  cards,  both 
sorted  by  suit  and  then  value — and  you  can  reset  either  deck  to  its  initial  state  using  two  Reset 
buttons.  The  form  also  has  buttons  (labeled  “«”  and  “>>”)  to  move  cards  between  the  decks. 


These  buttons  are  named  moveToPeckZ  (fop)  and  moveToPeckl 
(bottom)  They  move  cards  -Prom  one  deck  to  the  other. 


You  can  use  a  button’s 
Name  property  to  give  it  a 
name  to  make  your  code 
easier  to  read.  Then  when 
you  double-click  on  the 
button,  its  event  handler 
is  given  a  matching  name. 


Bach  of  the  reset/  and 
resetZ  buttons  first  calls  the' 
RedrawPeekO  method  and 
then  the  ResetPetkO  method 


Deck  #1  (9  cords) 

Two  of  Spades 
Five  of  Spades 
Four  of  Clubs 
Six  of  Clubs 
Ten  of  Diamonds 
Jack  of  Diamonds 
Four  of  Hearts 
Seven  of  Hearts 
King  of  Hearts 


Deck  #2  (52  cards) 

Ace  of  Spades 
Two  of  Spades  \C- 

our  of  Spades 
ive  of  Spades 
Six  of  Spades 
Seven  of  Spades 
Eight  of  Spades 
Nine  of  Spades 
Ten  of  Spades 
Jack  of  Spades 
Queen  of  Spades 
King  of  Spades 
Ace  of  Clubs 


^T"~Reset  Deck  #1 

1  Reset  Deck  #2 

Shuffle  Deck#1 

Shuffle  Deck  #2 

_ _ J 

Use  two  List  Box.  Controls  to 
.  show  the  two  decks.  When  the 
moveToPeckl  button  is  clicked, 
it  moves  the  selected  card 
■from  deck  #Z  to  deck  #/. 

These  buttons  are 
na»»ed  shuWlel  and 
Shutf  Ie2~  They  tall 
the  appropriate  Peck 
ShuWleO  method,  and 
then  redraw  the  deck 


In  addition  to  the  event  handlers  for  the  six  buttons,  you’ll  need  to  add  two  methods  for  the  form.  First  add  a 
ResetDeckQ  method,  which  resets  a  deck  to  its  initial  state.  It  takes  an  int  as  a  parameter:  if  it’s  passed  I,  it  resets 
the  first  Deck  object  by  reinitializing  it  to  an  empty  deck  and  a  random  number  of  up  to  1 0  random  cards;  if  it’s 
passed  2,  it  resets  the  second  Deck  object  so  that  it  contains  a  full  52-card  deck.  Then  add  this  method: 

private  void  RedrawDeck  (int  DeckNumber)  {  The  RedrawPeekO  method 

if  (DeckNumber  =1)  (  ^ - ^  updates  the  two  listbox 

Tk  a  look  at  listBoxl. Items. Clear  () ; 

.  foreach  (strinq  cardName  in  deckl .GetCardNames () ) 

how  we  used  the  -y - 

•foreach  loo  to  lxstBoxl.  Items. Add  (cardName) ; 

add  each  of  the  labell.Text  =  "Deck  #1  ("  +  deckl. Count  +  "  cards)"; 

Cards  in  the  -J  else  * 

deck  to  the  1  listBox2. Items. Clear  () ; 

listbo*  V.  foreach  (string  cardName  in  deck2  .GetCardNames  () ) 

listBox2 . Items .Add (cardName) ; 
labe!2.Text  =  "Deck  #2  ("  +  deck2. Count  +  "  cards)"; 


•  -  - 

t-onbrols  with  whatever 
happens  to  be  in  the  two 
Vctk  objects. 
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Build  the  Deck  class 


■  VW> en  you  Wave  the  declarations  for  a  class 
the  implementation,  it’s  called  a  “skeleton  . 


Deck 


Count 


x-  When  you  have  tne  declarations  TOT  a  Class  without 
the  implementatioi 

Here’s  the  skeleton  for  the  Deck  class.  We’ve  filled  in  several  of  the  methods  for  you.  You'll  need  to  finish  it 
by  writing  the  ShulfleO  iuid  GetCardNames0  methods,  ;uid  you'll  have  to  get  the  Sort()  method  to  work.  We 
also  added  two  useful  overloaded  constructors:  one  that  creates  a  complete  deck  of  52  cards,  and  the 
other  that  takes  an  array  of  Card  ohects  and  loads  them  into  the  deck. 

^  The  Deck  stores  its  cards  in  a  List— but  it  keeps 
public  class  Deck  {  yL  it  private  to  make  sure  it’s  well-encapsulated 
private  List<Card>  cards; 

private  Random  random  =  new  RandomO;  It  you  don  t  pass  parameters 

/  into  the  Constructor,  it  Creates 
a  Complete  deck  of  ?2-  cards 

for  (int  suit  =  0;  suit  <=  3;  suit++) 

for  (int  value  =  1;  value  <=  13;  value++) 

cards .Add (new  Card ( (Card. Suits) suit,  (Card. Values) value) ) ; 

) 


Add() 

DealQ 

GetCardNames() 
Shuffle) ) 

Sort() 


public  Deck (Card []  initialCards)  ( 

cards  =  new  List<Card> (initialCards) 

) 


This  overloaded  Constructor  takes  one 
parameter-an  array  of  cards,  which 
it  loads  as  the  initial  deck 


return  CardToDeal; 


) 


fiint:  The  ListBox 
Control’s  Selected  I  ndex 
property  will  be  the 
_  same  as  the  index  of 

he  Deal  method  deals  one  card  De  tard  in  the  list 
— ■  deck— it  removes  the  ybu  can  pass  it  directly 

Card  object  from  the  deck  and  D  fhe  DealO  method 

|f  no  card  is  selected, 
it’ll  be  less  than  zurro 
|n  that  case,  the 
moveToDeCk  button 
should  do  nothing 


public  int  Count  (  get  (  return  cards. Count;  ) 

public  void  Add (Card  cardToAdd) 
cards .Add (cardToAdd) ; 

) 

public  Card  Deal  (int  index)  (  returns  a  reference  to  it  Yc, 

Card  CardToDeal  =  cards  [index] ;  dea|  ^  .  , 

cards. BemoveAt  (index) ,  „  dta|  ^  J 

tk,  deck  by  ,b 

of  the  card  to  deal 


public  void  Shuffle ()  ( 

//  this  method  shuffles  the  cards  by  rearranging  them  in  a  random  order 

} 

public  string []  GetCardNames ( )  { 

//  this  method  returns  a  string  array  that  contains  each  card's  name 

) 


public  void  Sort()  { 

cards . Sort (new  CardComparer_bySuit ( ) ) ; 

} 

) 

Another  hint-  The  form  makes  it  really  easy  to  test  Your  ShuffU)  U.  a 

Keep  clicking  the  “Reset  Deck  #1"  hJf  7  i\  ^  °  we™od 

That'll  make  t  A  t  *  ,  rn  unt  ^  **  a  ^ec-WrA  deck, 

hat  II  make  rt  easy  to  see  .f  your  shuffling  £ode  works. 


You'll  need  to  write  the  ShuffleO 
^  method,  the  ^etCardNamesO 
method,  and  add  a  class  that 
implements  (Comparer  to  make  the 
ScrtO  method  work  And  you'll 
need  to  add  the  Card  class  you 
already  wrote  If  you  use  “Add 
Existing  Item”  to  add  iti  don’t 
forget  to  change  its  namespace 
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exercise  solution 


Build  a  class  to  store  a  deck  of  cards,  along  with  a  form  that  uses  it. 


SoLuttOM 


public  class  Deck  {  _  outs 

private  List<Card>  cards;  /  meai 

private  Random  random  =  new  Random ( ) ;  /  va|w 

public  DeckO  {  1/ 

cards  =  new  List<Card> () ;  tx 

for  (int  suit  =  0;  suit  <=  3;  suit++) 

for  (int  value  =  1;  value  <=  13;  value++) 
cards. Add(new  Card( (Card. Suits) suit. 


Here  s  -the  Constructor  -that  creates  a  Complete 
deck  of  ^2  cards.  It  uses  a  nested  for  loop  The 
outside  one  loops  through  the  four  suits  That 
means  the  inside  loop  that  goes  through  the  II 
values  runs  four  separate  times,  on Ce  per  suit- 


(Card. Values) value) ) ; 


public  Deck  (Card  []  initialCards)  (  ^ - 'hast' 

cards  =  new  List<Card> (initialCarcb) ;  .1. 

with 

public  int  Count  {  get  {  return  cards. Count;  }  ) 
public  void  Add (Card  cardToAdd)  { 
cards. Add (cardToAdd) ; 

public  Card  Deal (int  index)  (  ^  ^ 

Card  CardToDeal  =  cards [index] ;  ^ 

cards . RemoveAt ( index ) ;  „ 

remc 

return  CardToDeal; 

public  void  Shuffle ()  ( 

List<Card>  NewCards  =  new  List<Card> () ; 
while  (cards. Count  >0)  { 

int  CardToMove  =  random. Next (cards .Count) ; 
NewCards .Add (cards [CardToMove] ) ;  Your 

cards . RemoveAt (CardToMove) ; 

tree 


Here's  the  other  tonsWtor-th.s  ^ 
Has  two  overloaded  Constructors,  each 
u«th  different  parameters. 


Tht  Mi  *4  Deal  -ettod.  are  pretty 

„  tk.  Card, :  U  -n,e  Dat 

nda  method  adds  a  card  to  the  list 


cards  =  NewCards; 


yi„r  fjttOdlW*  ~<th«d  ■«* 

ereattararraYtkat.b,5«~r^fe 

Uda»  tk.  tard  ^  TU* "f  4 
(or  loop,  Wt  tori'*  al“  ““  ^ 


public  string[]  GetCardNames ( )  ( 

string []  CardNames  =  new  string [cards .Count] ; 
Tf’or)  (int  i  =  0;  i  <  cards. Count;  i++) 

"r  *  _ ...  _ ,  ,  1  _ 1  _  r  _■  1  1 1 _ .  I  La  CL 


CardNames[i]  =  cards [i] .Name; 
return  CardNames; 

) 

public  void  Sort ( )  { 

cards. Sort (new  CardComparer_bySuit () ) 

) 


The  Shuff leO  method  Creates  a  new  instance 
of  L«t<Cards>  called  NewCards  Then  it  pulls 
random  cards  out  of  the  Cards  f.eld  and  sticks 
b>em  in  New  Cards  until  Cards  is  empty  CnCe 
ST  *  done-  *  resets  the  Cards  field  to  point  to 
the  new  instance  The  old  instance  won't  have 
any  more  references  pointing  to  it  so  it'll  get 
Collected  by  the  garbage  Collector. 
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class  CardComparer_bySuit  :  ICoraparer<Card> 


public  int  Compare (Card  x.  Card  y) 

< 

if  (x.Suit  >  y.Suit) 
return  1; 

if  (x.Suit  <  y.Suit) 
return  -1; 

if  (x. Value  >  y. Value) 
return  1; 

if  (x. Value  <  y. Value) 
return  -1; 

return  0; 

) 

} 


Deck  deckl; 

Deck  deck2; 

Random  random  =  new  Random ( ) ; 


ScrtinJ  by  suit  is  a  lot  I'ke 
sorting  by  value  Tbe  only 
difference  is  that  m  this 
ease  -tbe  suits  are  compared 
■first,  and  then  tbe  values 
are  Compared  only  if  tbe 
Suits  match  ^ 


.nstead  of  usinj  if/ else 
if,  we  used  a  senes  of  if 


because  each  if  statement 
only  executes  if  tbe  previous 
one  didn’t— otherwise  tbe 
previous  one  would  have 
returned- 


public  ForralO  { 

InitializeComponent () ; 
ResetDeck (1 ) ; 
ResetDeck(2) ; 
RedrawDeck (1 ) ; 
RedrawDeck (2) ; 

) 


The  form’s  Constructor 
'  needs  to  reset  the  t*o 
decks,  and  then  it  draws 
them- 


private  void  ResetDeck ( int  deckNumber)  { 
if  (deckNumber  ==  1)  ( 

int  numberOf Cards  =  random. Next (1,  11); 
deckl  =  new  Deck (new  Card[]  (  }); 
for  (int  i  =  0;  i  <  numberOfCards;  i++) 

deckl .Add(new  Card( (Card. Suits) random. Next (4) , 

(Card. Values) random. Next (1,  14) ) ) ; 


deckl .Sort ( ) ; 

)  else 

deck2  =  new  Deck ( ) ; 

) 


You’ve  already  jot  the 
RedrawDeckO  method 
from  the  instructions. 


Creates  a  new  empty  deck  ll  r  ,  ’  d 

it  ,,  >  /  °eCK  ««  a  for  OOP  zAA 

instance  of  peck 0  ^  Clredte  a  new 


*•  We’re  not  done  yet-flip  the  page! 
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information  overload 


EmciSe 

Solution 

(coNtinuep) 


Naming  you*-  Controls  makes  it  a  lot  easie*-  to  'read 

your  Code  |f  these  were  called  buttonl _ Click, 

button 2-__CI>ck,  etc.,  y  ou  wouldn’t  know  which 
button's  Code  you  were  looking  at^ 


"<"'•tte.nt.ftt, 

tode  for  the  W 


private  void  resetl_Click (object  sender,  EventArgs  e)  {  \ 

ResetDeck (1) ;  J 

RedrawDeck (1 ) ;  / 

' 

private  void  reset2_Click (object  sender,  EventArgs  e)  {  V 
ResetDeck (2) ;  > 

RedrawDeck (2) ; 

)  I 

private  void  shuf f lel_Click (object  sender,  EventArgs  e)  { 
deckl .Shuffle ( ) ; 

RedrawDeck (1 ) ; 

) 

private  void  shuf fle2_Click (object  sender,  EventArgs  e)^j^ 
deck2 .Shuf fie ( ) ; 

RedrawDeck (2) ; 

) 

private  void  moveToDeckl_Click (object  sender,  EventArgs  e)  ( 
if  (listBox2 . Selectedlndex  >=  0) 
if  (deck2. Count  >0)  { 

deckl .Add (deck2.Deal (listBox2. Selectedlndex) ) ; 

) 

RedrawDeck (1) ; 

RedrawDeck (2) ; 


These  buttons  are 
fvetty  simple-first 
reset  or  shuffle  the 
deck,  then  redraw  it. 


private  void  moveToDeck2_Click  (object  sender,  EventArgs  e)  tybu  can  use  the  ListBox 

if  (listBoxl. Selectedlndex  >=  0)  Control’s  Selectedlndex  property 

if  (deckl  .Count  >0)  to  figure  out  which  Card  the 

deck2  .Add  (deckl  .Deal  (listBoxl . Selectedlndex) ) ;  use>.  se| ected  and  then  move  rt 

RedrawDeck  ( 1 ) ;  K  from  one  deck  to  the^oth^.  (It 

RedrawDeck  (2 ) ;  |ess  ^  ^  h0  ^  ^ 

selected,  so  the  button  does 
nothing.)  0nCe  the  Card's  moved, 
both  decks  need  to  be  redrawn 
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You  can  build  your  own  overloaded  methods 

You’ve  been  using  overloaded  methods  and  even  an  overloaded 
constructor  that  were  part  of  die  built-in  .NET  Framework  classes  and 
objects,  so  you  can  already  see  how  useful  they  are.  Wouldn't  it  be  cool 
if  you  could  build  overloaded  methods  into  your  own  classes?  Well,  you 
can — and  it’s  easy!  All  you  need  to  do  is  write  two  or  more  methods  that 
have  the  same  name  but  take  different  parameters. 

Create  a  new  project  and  add  the  Card  class  to  it. 

You  can  do  this  easily  by  right-clicking  on  the  project  in  the  Solution  Explorer  and  selecting  “Existing 
Item”  from  die  Add  menu.  The  IDE  will  make  a  copy  of  the  class  and  add  it  to  die  project.  The  file 
will  still  have  the  namespace  from  the  old  project,  so  go  to  the  lop  of  die  Card.cs  file  and 
change  the  namespace  line  to  match  the  name  of  the  newproject^ 

Q  Add  some  new  overloaded  methods  to  the  card  class. 

Create  two  static  DoesCardMatch  ( )  methods.  The  first  one  should  check  a  card’s  suit.  The 
second  should  check  its  value.  Both  return  true  only  if  the  card  matches. 


i.  />.  j  .1,..  Lvj 


Dp  tMs!  4- 


public  static  bool  DoesCardMatch (Card  CardToCheck,  Card. Suits  Suit)  ( 
if  (CardToCheck. Suit  ==  Suit)  { 

return  true;  Over loaded  methods  don't  have 

}  else  {  .  . 

return  false; 

> 


) 


k>  be  static,  but  it's  jood  to  jet 
J  little  practice  writing  static 
methods. 


public  static  bool  DoesCardMatch (Card  CardToCheck,  Card. Values  Value)  ( 
if  (CardToCheck .Value  ==  Value)  { 
return  true; 

)  else  { 

return  false; 

1 


Add  a  button  to  the  form  to  use  the  new  methods. 

Add  this  code  to  the  button: 


Card  CardToCheck  =  new  Card(Card. Suits. Clubs,  Card. Values .Three) ; 
bool  doesItMatch  =  Card. DoesCardMatch (cardToCheck,  Card. Suits. Hearts) ; 


As  soon  as  you  type  “DoesCardMatch  (”  the  IDE  will  show  you  that  you  really  did  build  an 

overloaded  method:  card  .DoesCardMatch  (| _ _ I 

w  1  of  2 1  bool  Card.DoesCardMatch  (Card  CardT oCheck ,  Card.Suts  Suit)  | 


Take  a  minute  and  play  around  with  the  two  methods  so  you  can  get  used  to  overloading. 
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go  fish! 


Afc> 


£oh£  Exercise 


Build  a  game  of  Go  Fish!  that  you  can  play  against  the  computer. 


O 


This  exercise  is  a  little  different... 

There’s  a  good  chance  that  you’re  learning  C#  because  you  want  a  job  as  a  professional  developer.  That’s 
why  we  modeled  this  exercise  after  a  professional  assignment.  When  you’re  working  as  a  programmer  on  a 
team,  you  don’t  usually  build  a  complete  program  from  start  to  finish.  Instead,  you’ll  build  a  piece  of  a  bigger 
program.  So  we’re  going  to  give  you  a  puzzle  that's  got  some  of  the  pieces  already  filled  in.  The  code  for  the 
form  is  all  on  the  next  page  in  step  #3.  You  just  have  to  type  it  in  which  may  seem  like  you’ve  got  a  great 
head  start,  but  it  means  that  your  classes  have  to  work  with  that  code.  And  that  can  be  a  challenge! 


Start  with  the  spec 

Every  professional  software  project  starts  with  a  specification,  and  this  one  is  no 
exception.  You’ll  lie  building  a  game  of  the  classic  card  game  Go  Fish!  Different 
people  play  the  game  by  slightly  different  rules,  so  here’s  a  recap  of  the  rules  you’ll 
be  using: 

*  file  game  starts  with  a  deck  of  52  cards.  Five  cards  are  dealt  to  each 
player.  The  pile  of  cards  that’s  left  after  everyone’s  dealt  a  hand  is  called 
the  stock.  Each  player  takes  turns  asking  for  a  value  (‘‘Do  you  have  any 
sevens?”).  Any  other  player  holding  cards  with  that  value  must  hand  them 
over.  If  nobody  has  a  card  with  that  value,  then  the  player  must  "go  fish” 
by  taking  a  card  from  the  stock. 

*  The  goal  of  the  game  is  to  make  books,  where  a  book  is  the  complete 
set  of  all  four  cards  that  have  the  same  value.  The  player  with  the  most 
Ijooks  at  die  end  of  the  game  is  the  winner.  .As  soon  as  a  player  collects 
a  book,  he  places  it  face-up  on  the  table  so  all  the  other  players  can  see 
what  books  everyone  else  has. 

*  When  a  player  places  a  book  on  the  table,  that  may  cause  him  to  run  out 
of  cards.  If  it  does,  then  he  has  to  draw  live  more  cards  from  the  stork. 

If  there  are  fewer  than  five  raids  left  in  the  stock,  he  takes  all  of  them. 
The  game  is  over  as  soon  as  the  stock  is  out  of  cards.  The  winner  is  then 
chosen  based  on  whoever  has  the  most  books. 

*  For  this  computer  version  of  Go  Fish,  there  are  two  computer  players  and 
one  human  player.  livery  round  starts  w  ith  the  human  player  selecting 
one  of  the  cards  in  his  hand,  which  is  displayed  at  all  times.  He  does  this 
by  choosing  one  of  the  cards  and  indicating  that  he  w  ill  ask  for  a  card. 
Then  the  two  computer  players  will  ask  for  their  cards.  The  results  of 
each  round  w  ill  lx-  displayed.  This  will  repeat  until  there’s  a  winner. 

*  The  game  w  ill  take  care  of  all  of  the  trading  of  cards  and  pulling  out  of 
Ixxiks  automatically.  Once  there’s  a  winner,  the  game  is  over.  The  game 
displays  the  name  of  the  winner  (or  winners,  in  case  of  a  tie).  No  other 
action  can  be  taken  the  player  will  have  to  restart  the  program  in  order 
to  start  a  new  game. 


If  you  cion’ I 
know  wTltal 
you’re  building 
before  you  start, 
tken  kow  would 
you  know'  w'ben 
you’re  done? 
That  s  wby  most 
professional 
software 
projects 
start  writb  a 
specification 
that  tells  you 
wTbat  you’re 
going  to  build. 
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Build  the  form 

Build  the  form  for  the  Go  Fish!  game.  It  should  have  a  ListBox  control  for  the  player's 
hand,  two  TextBox  controls  for  the  progress  of  the  game,  and  a  button  to  let  the  player 
ask  for  a  card.  To  play  the  game,  the  user  will  select  one  of  the  cards  from  the  hand  and 
click  the  button  to  ask  the  computer  players  if  you  have  that  card. 

This  TextBox  Control  should  have  its  Set  this  button's  P(.0[Vlo 

N^e  property  «t  to  ^ame  \  l  f*  ku iU£Ut  li's  disabled  * 

screenshot,  rt  s  disabled,  but  rt  should  be  &»*  ^reenshot  but  it  starts 


screening u  -v-  ^ — — — 

enabled  when  the  program  starts 


9ame  is  started 


*  Go  Fish! 


Your  name 

[Ed 


l- 


Start  the  came1 


These  are 
TextBox 
Controls  named 
te*tPr  ogress 
and  textBooks 


Game  progress 

Joe  has  3  Fives 
Bob  has  0  Fives 
Ed  drew  a  new  hand 
Joe  asks  rt  anyone  has  a  Ace 
jEd  has  1  Aces 
^tfob  has  OAces 
Joe  drew  a  new  hand 
Bob  asks  if  anyone  has  a  Nine 
Ed  has  0  Nines 
Joe  has  1  Nines 
Bob  drew  a  new  hand 
Ed  has  A  cards. 

Joe  has  A  cards. 

Bob  has  5  cards 

The  stock  has  1  cards  left 

Books 

Ed  has  a  book  of  Fours 
Ed  has  a  book  of  Fives 
loe  has  a  book  of  Aces 
Bob  has  a  book  of  Nines 


Your  Hand 

[Eight  of  Clubs 


Eight  of  Diamonds 


Eight  of  Hearts 


- 


King  of  Clubs 


1  Ask  for  o  card 


The  player’s 
Current  hand  is 
displayed  in  a 
ListBox  Control 
called  listttand 
You  can  set  its 
name  using  the 
Name  property 


jy  property 


Set  the  Read0n 
the  two  7ext£ 

Controls  to  True-that  will 
make  them  read-only  text 
boxes 


Set  this  button  s  Name  property  to 
button^ sk,  and  set  its  Enabled  property 
to  False  That  will  disable  it,  which 
means  it  can't  be  pressed  The  -form  will 
enable  it  as  soon  as  the  game  starts 

We  re  not  done  yel-flip  the  page! 
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here’s  the  form  code 


to h£  ExeRctSe  (coNtinuep) 

Q  Here's  the  cc 


Here's  the  code  for  the  form 

Enter  it  exactly  like  you  see  here.  The  rest  of  the  rode  that  you  write 
yourself  will  have  to  work  with  it. 
public  partial  class  Forml  :  Form  { 
public  Forml ()  { 

InitializeComponent () ; 

>  This  is  the  only  class  that  the  torm 

^ - — '  '  interacts  with  It  runs  the  whole  ^n-e 

private  Game  game; 


The  Enabled 
property  enable* 
^  disables  a 
Control  on  the 
(or«*>  ( 


T 

This  method 
clears  and 
repopulates 
the  ListBox 
that  holds 
the  player’s 
hand,  and  then 
updates  the  > 
text  boxes. 


private  void  buttonStart_Click (object  sender,  EventArgs  e)  ( 
if  (String. IsNullOrEmpty (textName. Text) ) I 
^  MessageBox. Show ("Please  enter  your  name",  "Can't  start  the  game  yet"); 

return; 

> 

,e  game  =  new  Game (textName .Text,  new  string!]  {  "Joe",  "Bob"  ),  textProgress) ; 
{buttonStart . Enabled  =  false; 

(textName. Enabled  =  false;  | (\ 

buttonAsk. Enabled  =  true;  \  V0*  a  r'e™  it  Creates  a  new 

UpdateFormO  ;  \.  instance  of  the  <$am e  class,  enables  the  “Ask" 

}  button,  disables  the  “Start  $ame"  button, 

and  then  redraws  the  torm. 

private  void  UpdateFormO  {  .. 

list  Hand.  Items  .Clear  ( ) ;  Sm9  SelectionStart  and 

foreach  (String  cardName  in  game.GetPlayerCardNames  () )  rollToCaretO  like  this 
listHand.Items.Add(cardName) ;  scrolls  the  text  box  to  t 

textBooks.Text  =  game.DescribeBooks  () ;  end,  so  it  there’s  too  mu< 

textProgress  .Text  +=  game.DescribePlayerHands  () ;  ^  text  -to  display  at  once  i-j 

textProgress  .  SelectionStart  =  textProgress .Text . Length; v  sCrolls  down  to  the  botte 
textProgress . ScrollToCaret  () ;  J  I 


private  void  buttonAsk_Click (object  sender,  EventArgs  e) 
textProgress .Text  =  ""; 
if  (listHand. Selectedlndex  <  0)  { 

MessageBox. Show ("Please  select  a  card"); 
return; 


Wsmj  SelectionStart  and 
ScrollTbCaretO  like  this 

trolls  the  text  box  to  the 
end,  so  it  there's  too  much 
)  k*t  to  display  at  once  it 
x  ^olls  down  to  the  bottom 

i 

'  he  SelectionStart  line  moves 
the  flashing  textbox  Cursor 
to  the  end,  and  onCe  it's 

-'°ved,  the  ScrollToCaretO 
method  scrolls  the  text  box 
down  to  the  Cursor 


if  (game. PlayOneRound (listHand. Selectedlndex) )  ( 

textProgress. Text  +=  "The  winner  is...  "  +  game .GetWinnerName () ; 
textBooks . Text  =  game . DescribeBooks ( ) ; 
buttonAsk. Enabled  =  false;  ti„  _i„.  .  , 

UpdateForm  ( ) ,  V  T  ^  4  ti 


^he  player  selects  one  of  +k*  >•>  j 
button  to  see  it  JhY  of  fk.  It  ^  ^  the  "Ask" 

matches  its  value.  The  <5ame  °b  T  f  Kdve  a  C3rd  ^*at 
PlayAie/^oundO  method  pby*  d  ***  usl"9  V* 
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You'll  need  this  code,  too 

You'll  need  the  code  you  wrote  before  for  the  Card  class,  the  Deck  class  and  the 
CardComparer  byValue  class.  But  you’ll  need  to  add  a  few  more  methods  to  the 
Deck  class...  and  you’ll  need  to  understand  them  in  order  to  use  them. 


""  TV  ^ctV.0  method  lets  you  take  a 

public  Card  Peek  (int  cardNumber)  1  peek  at  one  of  the  cards  in  the  deck 

return  cards  [cardNumber]  ;  without  dealing  it 


Someone  overloaded  DealO  to  make  it  a  little  easier 
public  Card  Deal  ()  {  dor^  £  ?ass  any  parameters,  it  deals 

return  Deal  (0) ;  ^  ^  ^  ^  j  detk 


public  bool  ContainsValue (Card. Values  value) 
foreach  (Card  card  in  cards) 
if  (card. Value  ==  value) 
return  true; 
return  false; 


Tile  Contains\/alueO  method  searches  through 
the  entire  deck  -for  cards  with  a  Certain  value, 
and  returns  true  if  it  -finds  any.  Can  you 
guess  how  you’ll  use  this  in  the  q o  Fish  game? 


) 


public  Deck  PullOutValues (Card. Values  value)  ( 
Deck  deckToReturn  =  new  Deck (new  Card[]  {  }) 
for  (int  i  =  cards. Count  -  1;  i  >=  0;  i — )^ 
if  (cards [i] .Value  ==  value) 
deckToReturn. Add (Deal (i) ) ; 
return  deckToReturn; 

) 


You  II  use  the  Pull0utl/aluesO 
method  when  you  build  the  Code  to 
get  a  book  of  cards  from  the  deck. 
It  looks  for  any  cards  that  match 
a  value,  pulls  them  out  of  the  deck, 
and  returns  a  new  deck  with  those 
cards  in  it- 


r- 


public  bool  HasBook (Card. Values  value) 
int  NumberOf Cards  =  0; 
foreach  (Card  card  in  cards) 
if  (card. Value  ==  value) 
NumberOf Cards++; 
if  (NumberOfCards  ==  4) 
return  true; 

else 

return  false; 

) 


public  void  SortByValue ( )  { 

cards. Sort (new  CardComparer_byValue () )  ;j 

} 


The  HasBookO  method  checks  a 
deck  to  see  if  it  Contains  a  book 
of  four  cards  of  whatever  value 
was  passed  as  the  parameter.  It 
returns  true  if  there's  a  book  in 
the  deck,  false  otherwise 

^  the  Comparer_by|/a|ue 


Still  not  done-flip  the  page! 
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347 


go  get  ’em  tiger! 


£ong  ExeRciSe  (continoep) 


Now  comes  the  HARD  part:  Build  the  Player  class 

There’s  an  instance  of  the  Player  class  for  each  of  the  three  players  in  the 
game.  They  get  created  by  the  buttonStart  button’s  event  handler. 


public  class  Player 
( 


Look  Closely  at  each  of  the  Co^e^ts-they  tell 
what  the  methods  are  supposed  h>  do.  yL 
job  is  to  fill  m  the  methods 


private  string  name; 

public  string  Name  {  get  {  return  name;  }  ) 
private  Random  random; 
private  Deck  cards; 
private  TextBox  textBoxOnForm; 

public  Player (String  name.  Random  random,  TextBox  textBoxOnForm)  { 

II  The  constructor  for  the  Player  class  initializes  four  private  fields, *Snd  then 
II  adds  a  line  to  the  TextBox  control  on  the  form  that  says,  "Joe  has  just 
//  joined  the  game"  -  but  use  the  name  in  the  private  field,  and  don't  forget  to 
//  add  line  break  ("\r\n")  at  the  end  of  every  line  you  add  to  the  TextBox 

} 

public  List<Card. Values>  PullOutBooks ( )  (  (  //  see  the  facing  page  for  the  code 

public  Card. Values  GetRandomValue ( )  { 

//  This  method  gets  a  random  value— but  it  has  to  be  a  value  that's  in  the  deck! 

) 


public  Deck  DoYouHaveAny (Card. Values  value)  ( 

//  This  is  where  an  opponent  asks  if  I  have  any  cards  of  a  certain  value 
II  use  Deck.PullOutValues ()  to  pull  out  the  values.  Add  a  line  to  the  TextBox 
II  that  says,  "Joe  has  3  sixes"  -  use  the  new  Card. Plural ()  static  method 


public  void  AskForACard (List<Player>  players,  int  mylndex.  Deck  stock)  { 

//  Here's  an  overloaded  version  of  AskForACard ( )  -  choose  a  random  value 
II  from  the  deck  using  GetRandomValue ( )  and  ask  for  it  using  AskForACard ( ) 

) 

public  void  AskForACard (List<Player>  players,  int  mylndex,  Deck  stock,  Card. Values  value)  ( 
//  Ask  the  other  players  for  a  value,  first  add  a  line  to  the  TextBox;  "Joe  asks 
II  if  anyone  has  a  Queen".  Then  go  through  the  list  of  players  that  was  passed  in 
II  as  a  parameter  and  ask  each  player  if  he  has  any  of  the  value  (using  his 
//  DoYouHaveAny ()  method).  He'll  pass  you  a  deck  of  cards  -  add  them  to  my  deck. 

//  Keep  track  of  how  many  cards  were  added.  If  there  weren't  any,  you'll  need 
//  to  deal  yourself  a  card  from  the  stock  (which  was  also  passed  as  a  parameter), 

//  and  you'll  have  to  add  a  line  to  the  TextBox:  "Joe  had  to  draw  from  the  stock" 

) 

//  Here's  a  property  and  a  few  short  methods  that  were  already  written  for  you 

public  int  CardCount  (  get  (  return  cards. Count;  )  ) 

public  void  TakeCard(Card  card)  (  cards .Add (card) ;  ) 

public  string!)  GetCardNames ( )  (  return  cards .GetCardNames () ;  ) 

public  Card  Peek (int  cardNumber)  (  return  cards . Peek (cardNumber) ;  ) 

public  void  SortHandO  (  cards . SortByValue () ;  ) 
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Ttot  PeekO  method  we  added  to  the  Deck  class  will  tome 
in  handy  It  lets  the  program  look  at  one  of  the  Cards  in 
the  detk  by  Jiving  its  inde*  number,  but  unlike  DealO  it 
doesn’t  remove  the  card 


public  List<Card.Values>  PullOutBooks ( )  { 

List<Card.Values>  Books  =  new  List<Card.Values>() ; 
for  (int  i  =  1;  i  <=  13;  i++)  { 

Card. Values  value  =  (Card. Values) i; 
int  howMany  =  0; 

for  (int  card  =0;  card  <  cards. Count;  card++) 
if  (cards . Peek (card) .Value  =  value) 
howMany++; 
if  (howMany  ==  4)  { 

Books .Add (value) ; 

for  (int  card  =  cards. Count  -  1;  card  >=  0; 
cards. Deal (card) ; 


) 


card — ) 


) 

return  Books; 


You  II  have  to  build  TWO  overloaded  versions  of  the 
AskFor ACardO  method  The  -first  one  is  used  by  the 
opponents  when  they  ask  for  cards— it'll  look  through 
their  hands  and  find  a  tard  to  ask  for  The  second 
one  is  used  when  the  player  asks  for  the  card  Both 
of  them  ask  BVBRY  other  player  (both  computer  and 
human)  for  any  cards  that  match  the  value 


You'll  need  to  add  this  method  to  the  Card  class 

It’s  a  static  method  to  take  a  value  and  return  its  plural — that  way  a  ten  will  return 
“Tens”  but  a  six  will  return  “Sixes”  (with  “cs”  on  the  end).  Since  it’s  static,  you  call  it 
with  the  class  name — Card.  Plural  ( )  — and  not  from  an  instance. 


public  partial  class  Card  ( 

public  static  string  Plural (Card. Values  value)  ( 
if  (value  ==  Values. Six) 
return  "Sixes"; 

else 

return  value. ToStr ing ( )  +  ”s"; 

1 

) 


Nearly  the  re-keep  flipping! 
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book  ’em  danno 


M 


t° h£  ExeRciSe  (continuep) 


The  rest  of  the  job:  Build  the  Same  class 

The  form  keeps  one  instance  of  Game.  It  manages  the  game  play.  Look 
tioselv  at  how  it’s  used  in  the  form. 


public  class  Game  { 

private  List<Player>  players; 

private  Dictionary<Card. Values,  Player>  books; 

private  Deck  stock; 

private  TextBox  textBoxOnForm; 


public  Game (string  playerName,  string[]  opponentNames,  TextBox  textBoxOnForm) 
Random  random  =  new  Random ( ) ; 
this. textBoxOnForm  -  textBoxOnForm; 
players  =  new  List<Player> ( ) ; 

players .Add (new  Player  (playerName,  random,  textBoxOnForm)); 
foreach  (string  player  in  opponentNames) 

players .Add (new  Player (player,  random,  textBoxOnForm)); 
books  =  new  Dictionary<Card. Values,  Player>(); 
stock  =  new  Deck(); 

Deal  ()  ; 

players [0] .SortHand  () ; 

) 


( 


private  void  Deal()  { 

//  This  is  where  the  game  starts  -  this  method's  only  called  at  the  beginning 
//  of  the  game.  Shuffle  the  stock,  deal  five  cards  to  each  player,  then  use  a 
II  foreach  loop  to  call  each  player's  PullOutBooks ( )  method. 


public  bool  PlayOneRound ( int  selectedPlayerCard)  { 

//  Play  one  round  of  the  game.  The  parameter  is  the  card  the  player  selected 
//  from  his  hand  -  get  its  value.  Then  go  through  all  of  the  players  and  call 
//  each  one's  AskForACard ()  methods,  starting  with  the  human  player  (who's  at 
//  at  index  zero  in  the  Players  list  -  make  sure  he  asks  for  the  selected 
//  card's  value).  Then  call  PullOutBooks ()  -  if  it  returns  true,  then  the 

II  player  ran  out  of  cards  and  needs  to  draw  a  new  hand.  After  all  the  players 

//  have  gone,  sort  the  human  player's  hand  (so  it  looks  nice  in  the  form). 

//  Then  check  the  stock  to  see  if  it's  out  of  cards.  If  it  is,  reset  the 

//  TextBox  on  the  form  to  say,  "The  stock  is  out  of  cards.  Game  over!"  and  return 

II  true.  Otherwise,  the  game  isn't  over  yet,  so  return  false. 


public  bool  PullOutBooks (Player  player)  { 

//  Pull  out  a  player's  books.  Return  true  if  the  player  ran  out  of  cards,  otherwise 
II  return  false.  Each  book  is  added  to  the  Books  dictionary.  A  player  runs  out  of 
//  cards  when  he's  used  all  of  his  cards  to  make  books— and  he  wins  the  game. 

) 

public  string  DescribeBooks ()  { 

//  Return  a  long  string  that  describes  everyone's  books  by  looking  at  the  Books 
//  dictionary:  "Joe  has  a  book  of  sixes,  (line  break)  Ed  has  a  book  of  Aces." 
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public  string  GetWinnerName ( )  { 

//  This  method  is  called  at  the  end  of  the  game.  It  uses  its  own  dictionary 
//  (Dictionary<string,  int>  winners)  to  keep  track  of  how  many  books  each  player 
//  ended  up  with  in  the  Books  dictionary.  First  it  uses  a  foreach  loop 
//on  Books. Keys  —  foreach  (Card. Values  value  in  Books. Keys)  —  to  populate 
//  its  winners  dictionary  with  the  number  of  books  each  player  ended  up  with. 

//  Then  it  loops  through  that  dictionary  to  find  the  largest  number  of  books 
//  any  winner  has.  And  finally  it  makes  one  last  pass  through  winners  to  come 
//  up  with  a  list  of  winners  in  a  string  ("Joe  and  Ed").  If  there's  one  winner, 
//  it  returns  a  string  like  this:  "Ed  with  3  books".  Otherwise  it  returns  a 
//  string  like  this:  "A  tie  between  Joe  and  Bob  with  2  books." 

} 

//  Here  are  a  couple  of  short  methods  that  were  already  written  for  you: 

public  string  []  GetPlayerCardNames ( )  { 

return  players [0] .GetCardNames () ; 

) 

public  string  DescribePlayerHands ( )  { 

string  description  = 

for  (int  i  =  0;  i  <  players. Count;  i++)  { 

description  +=  players [i] .Name  +  "  has  "  +  players (i) .CardCount; 
if  (players [i] .CardCount  =  1) 
description  +=  "  card.\r\n"; 

else 

description  +=  ”  cards. \r\n"; 

) 

description  +=  "The  stock  has  "  +  stock. Count  +  ”  cards  left."; 

return  description; 

( 


you  are  here  ► 
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Here  are  the  filled-in  methods  in  the  Game  class. 


The  DealO  method  gets  called  when  the 
game  first  starts— it  shuffles  the  deck  and 
/  '  then  deals  five  cards  to  each  player  Then 
it  pulls  out  any  books  that  the  players 


any 

happened  to  have  been  dealt 


public  class  Game  { 

private  void  Dealt)  ( 
stock. Shuffle () ; 
for  (int  i  =  0;  i  <  5;  i++) 

foreach  (Player  player  in  players) 
player. TakeCard (stock. Deal  () ) ; 
foreach  (Player  player  in  players) 
PullOutBooks (player) ; 

) 


public  bool  PlayOneRound ( int  selectedPlayerCard)  { 

Card. Values  cardToAskFor  =  players [0] .Peek (selectedPlayerCard) .Value; 
for  (int  i  =  0;  i  <  players .Count;  i++)  { 
if  (i  ==  0) 

players [0] .AskForACard (players,  0,  stock, 

else 

players [i] .AskForACard (players,  i,  stock) 
if  (PullOutBooks (players [il ) )  ( 

textBoxOnForm.Text  +=  players [i] .Name  +  " 


cardToAskFor) 


After  the  player  or 
opponent  asks  for  a 
^d,  the  game  pulls 
ovt  any  books  that  he 
made.  I f  a  player's  out 
of  books,  he  draws  a 
new  hand  by  dealing  up 
to  s  cards  from  the 
stock 


int  card  =1; 

while  (card  <=  5  &&  stock. Count  >  0) 
players[i] .TakeCard (stock. Deal () ) 
card++; 

) 

) 

players [ 0 ] . SortHand  ( ) ; 
if  (stock. Count  —  0)  { 

textBoxOnForm.Text  =  "The 
return  true; 


drew  a  new  hand\r\n"; 

(  As  Soon  as  the  player  clicks  the  “Ask 
for  a  card”  button,  the  game  calls 
AskForACard^  with  that  card  Then 
it  calls  AskForACardO  for  each 
opponent- 


stock  is  out  of  cards.  Game  over!\r\n"; 


} 

) 

return  false; 


A  After  the  round  is  played,  the  game  sorts  the 

l  p  ayer  s  hand,  to  make  sure  it's  displayed  m  order 

^  the  form.  Then  it  checks  to  see  if  the  game's 
over.  |f  it  is,  PlayOneRoundO  returns  true 


public  bool  PullOutBooks (Player  player) 

{ 

List<Card.Values>  BooksPulled  =  player .PullOutBooks () ; 
foreach  (Card. Values  value  in  BooksPulled) 
books .Add (value,  player); 
if  (player .CardCount  =  0) 
return  true; 
return  false; 


PullOutBooks 0  looks  through  a  player  s  cards  to  see 
if  he's  got  four  cards  with  the  same  value-  If  he 
does,  they  get  added  to  his  books  dictionary  And  -f 
he's  got  no  cards  left  afterwards,  it  returns  true 
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The  form  heeds  to  display  a  list  of  books, 
so  i-t  uses  DesCribeTheBooksO  to  turn  the 
player's  books  dictionary  into  words 

public  string  DescribeBooks ( )  ( 
string  whoHasWhichBooks  = 
foreach  (Card. Values  value  in  books. Keys) 

whoHasWhichBooks  +=  books ( value ]. Name  +  ”  has  a  book  of  " 

+  Card. Plural (value)  +  "\r\n"; 
return  whoHasWhichBooks; 

) 


public  string  GetWinnerName ( )  { 

Dictionary<string,  int>  winners  =  new  Dictionary<string, 
foreach  (Card. Values  value  in  books. Keys)  { 

string  name  =  books [value] .Name;  ' 

if  (winners .ContainsKey (name) ) 
winners [name] ++; 

else 

winners .Add (name,  1); 


int>() 


0nCe  the  last  card's  been  picked  up,  the , 
^ame  needs  to  -figure  out  who  won  That  s 
what  the  ^jetlAfmnerNameO  does  And 
it’ll  use  a  dictionary  called  winners  to 
do  it  Bach  player's  name  is  a  key  m  the 
dictionary;  its  value  is  the  number  ot  books 
that  player  got  during  the  game 


int  mostBooks  =  0; 

foreach  (string  name  in  winners .Keys) 
if  (winners [name]  >  mostBooks) 
mostBooks  =  winners [name] 
bool  tie  =  false; 

string  winnerList  =  to  f.gure  the  number  of  books  that  the 

foreach  (string  name  in  winners .Keys)  .  3  .  l  wt 

if  (winners  [name]  ==  mostBooks)  mos^  It  puts 

{  that  value  in  a  variable  called  mostBooks. 

if  ( ! String. IsNullOrEmpty (winnerList) ) 


Ne*t  the  game  looks  through  the  dictionary 
to  fiAure  the  number  of  books 


( 


} 


winnerList  += 
tie  =  true; 


and 


winnerList  +=  name; 


} 


with  "  +  mostBooks  +  "  books"; 


winnerList  += 
if  (tie) 

return  "A  tie  between  "  +  winnerList; 

else 

return  winnerList; 


Now  that  we  know  which  player 
has  the  most  books,  the  method 
Can  Come  up  with  a  string  that 
\lists  the  winner  (or  winners). 


*■  We’re  not  done  yet-flip  tlie  page! 


you  are  here  ► 
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§OLyt»OH  (coHtiHuGp) 

Here  are  the  filled-in  methods  in  the  Player  class. 


public  Player (String  name.  Random  random,  TextBox  textBoxOnForm)  { 

this. name  =  name;  Here's  the  Constructor  U  the  Player  class 

this. random  =  random;  ii  i,  t  ^ ■  <  r u  ,  i.  . 

...  .  .n  _  „  .  It  sets  its  private  Fields  and  the  adds  a  ine 

this. textBoxOnForm  =  textBoxOnForm;  l  1l  .  ,  , 

this. cards  =  new  Deck  (  new  Card[]  { }  ) ;  the  bo*  **"9  *Ko 

textBoxOnForm. Text  +=  name  +  "  has  just  joined  the  game\r\n"; 

} 

public  Card. Values  GetRandomValue ()  t  ^ 

Card  randomCard  =  cards .  Peek  (random. Next  (cards  .Count) ) ;  ) 

return  randomCard. Value;  $ctRa„dom\/alueO  method  uses  PeekO  to 

look  at  a  random  card  in  the  player’s  hand 


public  Deck  DoYouHaveAny (Card. Values  value)  { 

Deck  cardsIHave  =  cards . PullOutValues (value) ; 
textBoxOnForm. Text  +=  Name  +  "  has  "  +  cardsIHave .Count  + 
+  Card. Plural (value)  +  "\r\n"; 
return  cardsIHave; 

> 


DoyiuHaveAnyO  uses 
"  "  the  PullOuti/aluesO 
fT  method  to  full  out  and 

^ - -  return  all  cards  that 

match  the  parameter. 


public  void  AskForACard (List<Player>  players,  int  mylndex,  Deck  stock)  { 

Card.  Values  randomValue  =  GetRandomValue  () ;  There  are  two  overloaded 

AskForACard  (players,  mylndex,  stock,  randomValue);  ^  kForACardO  methods  This  one 

used  by  the  oPponents-'t  5«ts 

.  ,  ,  2  vendor*  tdrd  ( VOm  the  hand  and 

public  void  AskForACard (List<Player>  players,  int  mylndex,  r*n*  .  .  » r  ./•. 

Deck  stock.  Card. Values  value)  (  calls  the  other  AskorACardU 


textBoxOnForm. Text  +=  Name 
int  totalCardsGiven  =0; 
for  (int  i  =  0;  i  <  players .Count; 
if  (i  !=  mylndex)  { 

Player  player  =  players [i 


asks  if  anyone  has  a  "  +  value  +  "\r\n"; 


i++)  ( 


This  AskForACardO  method 

_ _  looks  through  every  player 

Deck  CardsGiven  =  player.  DoYouHaveAny  (value) ;  (e*Cept  -for  the  one  asking), 
totalCardsGiven  +=  CardsGiven. Count;  calls  its  DoyiutfaveAnyO 

while  (CardsGiven. Count  >  0)  method,  and  adds  any  cards 

cards  .Add  (CardsGiven .  Deal  ( ) ) ;  handed  over  to  the  hand 


) 


} 

if 


(totalCardsGiven  ==  0)  ( 
textBoxOnForm. Text  +=  Name 
cards .Add (stock . Deal ( )  ) ; 


+  ”  must  draw  from  the  stock. \r\n"; 

rv.  |-f  no  Cards  were  handed  over,  the 
player  has  to  draw  £rom  the  stock 
usin^  its  DealO  method 
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And  yet  MORE  collection  types... 


List  and  Dictionary  objects  are  two  of  the  built-in  generic  collections  that  are 
part  of  the  .NE  T  framework.  Lists  and  dictionaries  are  very  flexible — you  can  access  any 
of  the  data  in  them  in  any  order.  But  sometimes  you  need  to  restrict  how  your  program 
works  with  the  data  because  the  thing  that  you’re  representing  inside  your  program  works 
like  that  in  the  real  world.  For  situations  like  that,  you'll  use  a  Queue  or  a  Stack.  Those 
are  the  other  two  generic  collections  that  are  similar  to  lists,  but  they’re  especially  good  at 
making  sure  that  your  data  is  processed  in  a  certain  order. 


There  are  other  ^ 

r " 

i  i  l.  A.  1**  t.orr>t  m 


Use  a  Queue  when  the  first 
object  you  store  will  be  the  first 
one  you’ll  use,  like: 

*  Cars  moving  down  a  one-way  street 

*  People  standing  in  line 

*  Customers  on  hold  for  a  customer 
service  support  line 


Anything  else  that’s  handled  on  a 
first-come,  first-served  basis 


V  A  <\ueue  is  -first-in  -first-out,  which 
«*>eans  that  the  first  object  that 
you  put  into  the  m«eue  is  the  -first 
one  you  full  out  of  it  to  use 


Use  a  Stack  when  you  always  want 
to  use  the  object  you  stored  most 
recently,  like: 

★  Furniture  loaded  into  the  back  of  a 
moving  truck 

★  A  stack  of  books  where  you  want  to 
read  the  most  recently  added  one  first 

★  A  pyramid  of  cheerleaders,  where  the 
ones  on  top  have  to  dismount  first... 
imagine  the  mess  if  the  one  on  the 
bottom  walked  away  first! 

The  stack  is  first-m  last-out— the 
first  object  that  y>es  into  the  stack 
is  the  last  one  that  Comes  out  of  it- 


Generic  collections  are  an  important  part  of 
the  .NET  framework 

They’re  really  useful — so  much  that  the  IDE  automatically  adds 
this  statement  to  the  top  of  every  class  you  add  to  your  project: 

using  System . Collections • Generic; 

Almost  every  large  project  that  you’ll  work  on  will  include  some 
sort  of  generic  collection,  because  your  programs  need  to  store 
data.  And  when  you’re  dealing  with  groups  of  similar  things  in 
the  real  world,  they  almost  always  naturally  fall  into  a  category 
that  corresponds  pretty  well  to  one  of  these  kinds  collections. 

You  can,  however,  use  foreach  -to  / 
enumerate  through  a  stack  er  «\ueue, 
because  they  implement  (Enumerable 


A  cjueue  is  like  a  list 
tkat  lets  you  put 
objects  on  tke  end  of 
tke  list  and  use  tke 
ones  on  tke  front.  A 
stack  only  lets  you 
access  tke  last  object 
you  put  into  it. 
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don't  you  hate  waiting  in  line? 


A  queue  is  FIFO  —  First  In,  First  Out 

A  queue  is  a  lot  like  a  list,  except  that  you  can’t  just  add  or  remove  items  at  any 
index.  To  add  an  object  to  a  queue,  you  enqueue  it.  1'hat  adds  the  object  to  the 
end  of  the  queue.  You  can  dequeue  the  first  object  from  the  front  of  the  queue. 
When  you  do  that,  the  object  is  removed  from  the  queue,  and  the  rest  of  the  objects 
in  the  queue  move  up  a  position. 


Create  a  ^ 
new  «\ueue 
of  strinos 


PeekO  lets 
you  take 
a  "look"  at 
the  ■first-' — 
item  in  the 
gueue  without 
removing  it- 


Queue<string>  myQueue  =  new  Queue<string> () ; 

myQueue  .  Enqueue  ("first  in  line");  N  Here  s  where  we 

/  items  to  the  <\veue  lAAien  we 

myQueue  .  Enqueue  ("second  in  line");  V,  out  "tKe  oywcuC’ 

myQueue  .  Enqueue  ("third  in  line")  ;  C  they’ll  tome  out  m  the  same 

)  r*-der  they  went  iiu 

IT n m mnn  /  "  1  3cf  i  n  1  i  \  •  /  O' vA  f 


The  ClearO 

method 


myQueue  .  Enqueue  ("third  in  line");  \  they  II  tome  out  m  we 

)  nrAer  they  went  >n- 

myQueue . Enqueue ("last  in  line");  _ J  7 

^  string  takeALook  =  myQueue . Peek ( )  ;0 

string  getFirst  =  myQueue .  Dequeue  ()  ;@~1  -first  item  outo-Tth  ^ 
string  getNext  =  myQueue  .  Dequeue  ( )  ;0  J  second  one  shhftTup 

int  howMany  =  myQueue .  Count ;® 

^  myQueue  .  Clear  ( )  ;  one  out  next. 

MessageBox. Show ("Peek()  returned:  "  +  takeALook  +  "\n" 

+  "The  first  Dequeue ()  returned:  "  +  getFirst  +  "\n" 


The  second  Dequeue ()  returned:  "  +  getNext  + 
Count  before  Clear  ()  was  "  +  howMany  +  "\n" 
Count  after  ClearO  is  now  "  +  myQueue . Count) 


The  gueue  s  Count  property  returns 
the  number  of  items  in  the  queue 


PeekO  returned:  first  in  line© 

The  first  Dequeue 0  returned:  first  in  line© 

The  second  DequeueO  returned:  second  in  line 
Count  before  ClearO  was  2©  © 

Count  after  ClearO  is  now  o@ 
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A  stack  is  LIFO  —  Last  In,  First  Out 


A  stack  is  really  similar  to  a  queue  with  one  big  difference.  You  push  each  item 

onto  a  stack,  and  when  you  want  to  take  an  item  from  the  stack  you  pop  one  of 

it.  When  you  pop  an  item  off  of  a  stack,  you  end  up  with  the  most  recent  item  that 

you  pushed  onto  it.  It’s  just  like  a  stack  of  plates,  magazines  or  anything  else — you 

can  drop  something  onto  the  top  of  the  stack,  hut  you  need  to  lake  it  off  before  you 

can  get  to  whatever’s  underneath  it.  „  .  i  .  ■  ■  ri 

*  Creates  a  stack  «  just 

like  creating  any  other 

WKer,  you  push  V***  t0"edyo" 

a  te«*>  onto  a  Stack<string>  myStack  =  new  Stack<string>  ( )  ; 

stack,  it  pushes  myStack  (Ssh)"  first  in  line"); 

the  other  items  jjjyg^ack .  push  ("second  in  line"); 
back  one  notch  1 

and  sits  on  to?  myStack .  Push  ("third  in  line"); 

myStack . Push ("last  in  line"); 

Ostring  takeALook  =  myStack . Peek ( ) 

Ostxing  getFirst  =  myStack . Pop () ; 

Ostring  getNext  =  myStack . Pop () ; 

Qint  howMany  =  myStack . Count ; 
myStack . Clear ( ) ; 

MessageBox . Show ("Peek ( )  returned: 

+  "The  first  Pop()  returned: 

+  "The  second  Pop()  returned: 

+  "Count  before  Clear ()  was  "  +  howMany  +  "\n" 
+  "Count  after  Clear ()  is  now 


When  you  pop  an  item 
off  the  stack,  you  jet 
the  most  recent  item 
that  u<as  added 


>\ 


takeALook 
+  getFirst  + 
+  getNext  + 


+  "\n" 

"\n" 

"\n" 


+  myStack . Count) ; 

o 


PeekO  returned :  last  in  line  O 
The  first  PopO  returned:  last  in  lineO 
The  second  PopO  returned:  third  in  line 
Count  before  Clear  0  was  20  O 
Count  after  Clear  0  is  now  0  Q 


OK 


The  last  object  you  put 
on  a  stack  is  the  -first 
object  that  you  pull 
off  of  it-  \ 


you  are  here  ► 
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flapjacks  and  lumberjacks 


Wait  a  minute,  something's  bugging  me.  You 
haven't  shown  me  anything  I  can  do  with  a  stack 
or  a  queue  that  I  can’t  do  with  a  list— they  just 
save  me  a  couple  of  lines  of  code.  But  I  can't  get  at 
the  items  in  the  middle  of  a  stack  or  a  queue.  I  can 
do  that  with  a  list  pretty  easily!  So  why  would  I 
give  that  up  just  for  a  little  convenience? 


Don’t  worry — you  don’t  give  up  anything  when 
you  use  a  queue  or  a  stack. 

It’s  really  easy  to  convert  a  Queue  object  to  a  List  object.  And  it’s 
just  as  easy  to  convert  a  List  to  a  Queue,  a  Queue  to  a  Stack...  in 
fact,  you  can  create  a  List.  Queue  or  Stack  from  any  other  object 
that  implements  the  IEnumerable  interface.  All  you  have  to  do 
is  use  the  overloaded  constructor  that  lets  you  pass  the  collection 
you  want  to  copy  from  as  a  parameter.  That  means  you  have  the 
flexibility  and  convenience  of  representing  your  data  with  the 
collection  that  best  matches  the  way  you  need  to  be  used. 


Let's  set  up  a  stack  with 
W  items-,*  this  case,  a 
stack  or  strings. 


Stack<string>  myStack  =  new  Stack<string> () ; 
myStack. Push ("first  in  line"); 
myStack . Push ( "second  in  line" )  ; 

myStack .  Push  ( "third  in  line")  ;  ^  a  ||S^  then  copy  the  list 

myStack.  Push  ("last  in  line");  to  another  stack 

Queue<string>  myQueue  =  new  Queue<string> (myStack) ; 
List<string>  myList  =  new  List<string> (myQueue) ; 

Stack<string>  anotherStack  =  new  Stack<string> (myList) ; 
MessageBox . Show ("myQueue  has  "  +  myQueue . Count  +  "  items\n" 

+  "myList  has  "  +  myList. Count  +  "  items\n" 

+  "anotherStack  has  "  +  anotherStack . Count  +  "  items\n") ; 


B 


f\W  four  items  were 
Copied  into  the  new 

Collections  \ 


myQueue  has  4  items 
myList  has  4  items 
anotherStack  has  4  Items 


OK 


...and  you  can  always  use 
a  foreach  loop  to  access 
all  of  the  members  in  a 
stack  or  a  queue! 
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ExeneiSe 

O 


Write  a  program  to  help  a  cafeteria  full  of  lumberjacks  eat  some  flapjacks.  Start  with  the  Lumberjack 
class,  filling  in  the  missing  code.  Then  design  the  form,  and  add  the  button  event  handlers  to  it. 


Here's  the  Lumberjack  class.  Fill  in  the  get  accessor  lor  FlapjackCount 
and  the  TakeFlapjacks  and  EatFlap jacks  methods. 

public  class  Lumberjack  { 
private  string  name; 

public  string  Name  {  get  (  return  name; 
private  Stack<Flapjack>  meal,*' 
public  Lumber jack (string  name)  ( 
this. name  =  name; 
meal  =  new  Stack<Flapjack> () ; 

1 

public  int  FlapjackCount  {  get  (  //  return  the  count  } 

public  void  TakeFlapjacks (Flapjack  Food,  int  HowMany) 

II  Add  some  number  of  flapjacks  to  the  Meal  stack 

} 

public  void  EatFlapjacks ()  { 

//  Write  this  output  to  the  console - * 

} 


public  enum  Flapjack  { 
crispy, 
soggy, 
browned, 
banana 


1 


1 

O 


1 

□ 

Ed1 

s  eacing  flapjacks 

A 

Ed 

ace 

crispy  flapjack 

Ed 

ace 

soggy  flapjack 

Ed 

ace 

browned  flapjack 

Ed 

ace 

browned  flapjack 

Ed 

ace 

banana  flapjack 

Ed 

ace 

banana  flapjack 

Ed 

ace 

banana  flapjack 

Ed 

ace 

soggy  flapjack 

Ed 

ace 

crispy  flapjack 

w 

< 

— 

> 

J 

Build  this  form.  It  lets  you  enter  the  names  of  lumberjacks  into  a  text  box  so  they  get  m  the  breakfast 
line.  You  can  give  the  lumberjack  at  the  front  of  the  line  a  plate  of  flapjacks,  and  then  tell  him  to  move 
on  to  eat  them  using  the  “Next  lumberjack"  button.  We’ve  given  you  the  click  event  handler  for  the  “Add 
flapjacks”  button.  Use  a  queue  called  breakf  astLine  to  keep  track  of  die  lumberjacks. 


’  Brtakfist  for  Lumborjacki 


Lumberjack  Nome 
1  Add  Lurobenock  1 

Breokfon  Line 

1  Ed 

2  Bifly 

3  Jones 
A  Fred 

5  Johansen 

6  Bobby  Jr 

This  listbox 
is  failed 
line. 


Igj 

Feed  o  Lumberjack 

|i - 3 

O  crispy 
O  Soggy 
®  Browned 
O  Banana 
j  Add  flapiock.s  ■ 

Ed  has  8  flapjacks 

1  I-  .1  u  i if.  v- 


JVW.  tk,  "Add  U-b^k”,  ,dd  th, 

the  name  text  box  to  the  BreakfastLine  ^ueue 

^  drt5  tk« 

5  y  ill™,  tw  »>„  At*1  •"*  •**?*,? 1 
j*  at  jddFUfjJtb.Ork  >*** 


on 

Look - 

out  what  they  should  be  "a",ed 


Click  (...)  { 


Note  the  spedal 
"else  if”  syntax 


This  button  should  dequeue 
the  next  lumber jatk,  call  his 
EatFlapjaeks  method!  and  then 
redraw  the  listbox 


private  void  addFlapj; 

Flapiack  food; 
if  Qcrispy.CheckecT>=  true) 
food  =  Flap jack. crispy; 
else  if  (soggy. Checked  —  true) 
food  =  Flap jack. soggy; 
else  if  (browned. Checked  ==  true) 

food  =  Flap  jack,  browned;  peek()  returns  a  reference 
else  to  the  first  lumberjack  in 

the  <\ueue  ^ ^ 

Lumberjack  currentLumberjack  =  breakf astLine. Peek () 
cur rentLumber j  ack . TakeFlap j  acks ( food, 

( int ) howMany . Value ) 


food  =  Flap jack. banana; 


You  II  need  to  add  a  RedrawListO  method 

to  update  the  listbox  with  the  Contents  — ^  _ _ _ _ 

of  the  <\ueue  All  three  buttons  will  call  it-  ^^edrawList  () ;  J ^  NumericMpDown  Control  is  called 
Here's  a  hint  it  uses  a  foreach  loop. _ j _ howMany,  and  the  label  is  called  nextlnLine 


you  are  here  ► 
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exercise  solution 


S°lwiioH 


private  QueuecLumber jack>  breakfastLine  =  new  Queue<Lumberjack> () 
private  void  addLumber jack_Click (object  sender,  EventArgs  e)  { 
breakfastLine .Enqueue (new  Lumberjack (name. Text) ) ; 
name. Text  = 


RedrawList () ; 


Ue'  kcU 


The  RedrjwL, siO 
method  uses  3 

loop  to  pu|| 
the  lumberjacks  out 
0+  their  «^ueue  and 
Add  each  of  ihem  1 0 
the  listbox. 


private  void  RedrawList  ( )  {  /  the  two  bu-/4  «  '*e  '  the  la 

int  number  =  1;  — • - y  %  r'e*t/nL.ine" 

line. Items .Clear (T; 

)  C  foreach  (Lumberjack  lumberjack  in  breakfastLine)  ( 

\  line.  I  terns.  Add  (number  +  "  +  lumber  jack.  Name)  ; 

)  number ++; 


This  if  statement  updates  the 

rf  (breakfastLxne  Count  -  0)  I  *  ^  about  the 

groupBoxl  .Enabled  =  false;  iaoei  wu.n  m-v 

nextlnLine.Text  =  first  lumberjatk  in  the  <\ueue 

}  else  { 

groupBoxl .Enabled  =  true; 

Lumberjack  currentLumber jack  =  breakfastLine. Peek () ; 
nextlnLine.Text  =  currentLumber jack. Name  +  ”  has  " 

+  currentLumber jack. FlapjackCount  +  w  flapjacks" 


private  void  nextLumber jack_Click (object  sender,  EventArgs  e)  ( 
Lumberjack  nextLumber jack  =  breakfastLine. Dequeue () ; 
nextLumber jack. EatFlapjacks () ; 
nextlnLine.Text  = 

RedrawList () ; 

) 

public  class  Lumberjack  { 
private  string  name; 

public  string  Name  {  get  {  return  name;  )  } 
private  Stack<Flapjack>  meal; 

public  Lumber jack (string  name)  ( 
this. name  =  name; 
meal  =  new  Stack<Flapjack> ( ) ; 

} 


The  TakeFlapjacks 
method  updates  th 
Meal  statk  1 


I  f  P^ht  Ou{  J-L 

Zi  e 


public  int  FlapjackCount  (  get  (  return  meal. Count;  )  } 

public  void  TakeFlapjacks (Flapjack  food,  int  howMany)  ( 
^  for  (int  i  =  0;  i  <  howMany;  i++)  ( 
meal .Push (food) ; 

}  > 

public  void  EatFlapjacks ()  { 

/Console. WriteLine (name  +  s  eating  flapjacks"); 
while  (meal. Count  >0)  ( 

Console. WriteLine (name  +  "  ate  a  " 

+  meal . Pop () .ToString ()  +  "  flapjack"); 

I  1 
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Across 

3.  An  instance  of  a _ collection  only  works  with 

one  specific  type 

6.  A  special  kind  of  loop  that  only  works  on  collections 
9  The  name  of  the  method  you  use  to  send  a  string  to  the 
output 

10.  How  you  remove  something  from  a  stack 

11.  An  object  that's  like  an  array  but  more  flexible 

13.  Two  methods  in  a  class  with  the  same  name  but  different 
parameters  are... 

15.  A  method  to  figure  out  if  a  certain  object  is  in  a  collection 
19.  An  easy  way  to  keep  track  of  categories 
20  All  generic  collections  implement  this  interface 
21 .  How  you  remove  something  from  a  queue 


Down 

1  The  genenc  collection  that  lets  you  map  keys  to  values 
2.  This  collection  is  first-in,  first-out 
4  The  built-in  class  that  lets  your  program  write  text  to  the 
output 

5.  A  method  to  find  out  how  many  things  are  in  a  collection 

7.  The  only  method  in  the  IComparable  interface 

8.  Most  professional  projects  start  with  this 

12.  An  object  that  implements  this  interface  helps  your  list  sort 
its  contents 

14  How  you  add  something  to  a  queue 

16.  This  collection  is  first-in,  last-out 

17.  How  you  add  something  to  a  stack 

18.  This  method  returns  the  next  object  to  come  off  of  a  stack  or 
queue 


you  are  here  > 


361 


crossword  solution 


Collectioncross  solution 
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Name: 


This  lab  gives  you  a  spec  that  describes  a  program 
for  you  to  build,  using  the  knowledge  you’ve  gained 
over  the  last  few  chapters. 


This  project  is  bigger  than  the  ones  you’ve  seen  so 
far.  So  read  the  whole  thing  before  you  get  started, 
and  give  yourself  a  little  time.  And  don’t  worry  if 
you  get  stuck— there’s  nothing  new  in  here,  so  you 
can  move  on  in  the  book  and  come  back  to  the  lab 
later. 

We’ve  filled  in  a  few  design  details  for  you,  and 
we’ve  made  sure  you’ve  got  all  the  pieces  you 
need...  and  nothing  else. 

It’s  up  to  you  to  finish  the  job.  You  can  download 
an  executable  for  this  lab  from  the  website...  but 
we  won’t  give  you  the  code  for  the  answer. 


C#  Lab  363 


The  spec:  build  an  adventure  game 

Your  job  is  to  build  an  adventure  game  where  a  mighty  adventurer 
is  on  a  quest  to  defeat  level  after  level  of  deadly  enemies.  You’ll 
build  a  turn-based  system,  which  means  the  player  makes 


The  enemies  get  a  bit 
of  an  advantage— they 
move  every  turn,  and 


- move  every  turn,  and 

one  move  and  then  the  enemies  make  one  move.  1  he  player  can  after  the  th  ’ll 

move  or  attack,  and  then  each  enemy  gets  a  chance  to  move  and  ,,  .  , .  '  .  f  {  , 

■  ....  ,  •  MiT  i  ic  it  i  attack  the  player  if  he: 

attack.  I  he  game  keeps  going  until  the  player  either  defeats  all  the  1  ' 

ii  i  ,  j-  1  ^nge 

enemies  on  all  seven  levels  or  dies. 


The  game  window  gives  an  overhead 
view  of  the  dungeon  where  the 
flayer  fights  his  enemies 

The  flayer  can  fick 
\  uf  weafons  and 

A  /  fotions  along  the  way 


The  flayer  and 
enemies  move  around 
in  the  dungeon 


The  flayer  moves 
“Si  *3  the  four 
AJove  buttons.  \ 


Here's  the  flayer's  inventory  It  shows 
what  items  the  flayer's  ficked  uf,  and 
draws  a  bo*  around  the  item  that 
they're  Currently  using  The  flayer 
clicks  on  an  item  to  e<\uiP  rt.  uSeS 
the  Attack  button  to  use  the  item 


The  game  shows  you  the  number  of 
hit  foints  for  the  flayer  and  enemies 
When  the  flayer  attach  an  enemy, 
the  enemy's  hit  foints  go  down.  OnCe 
the  hit  foints  get  down  to  tero,  the 
enemy  or  flayer  dies. 


These  four  buttons  are 
used  to  attack  enemies 
and  drink  fotions- 
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The  Quest 


The  player  picks  up  weapons... 

There  are  weapons  and  potions  scattered  around  the 
dungeon  that  the  player  can  pick  up  and  use  to  defeat  his 
enemies.  All  he  has  to  do  is  move  onto  a  weapon  and  it 
disappears  front  the  floor  and  appears  in  his  inventory. 


A  black  bo%  around  a  weapon  means  it’s  seventy 

equipped  Deferent  weapons  work  di«e 
d^Tent  ranges,  some  only  attack  in  One 
others  have  a  wider  rany,  and  they  cause  deferent 
levels  of  damage  to  the  enem.es  they  b.t 


...and  attacks  enemies  with  them 

Every  level  in  the  game  has  a  weapon  that  the  player  can 
pick  up  and  use  to  defeat  his  enemies.  Once  the  weapon's 
picked  up,  it  should  disap|>ear  front  the  game  floor. 


The  bat  is  to  the  right  of 
the  flayer,  so  be  bits  tbe 
Right  attack  button 


The  attack  causes  the 
bat’s  hit  points  to 
drop,  from  4  to  Z  in 
this  case-  - 


Higher  levels  bring  more  enemies 

There  are  three  different  kinds  of  enemies:  a  bat,  a  ghost,  and 
a  ghoul.  The  first  level  only  has  a  hat.  The  seventh  level  is  the 
last  one,  and  it  has  all  three  enemies. 


The  bat  flies 
around  somewhat 

randomly  W>eh  ifs 
near  the  player, 
it  causes  a  small 
amount  of  damage 


A  ghoul  moves  guickly 
■towards  tbe  player,  and 
causes  heavy  damage 
when  it  attacks. 


The  ghost  moves  slowly  towards  tbe 
player  As  soon  as  its  close  to  tbe 
player,  it  attacks  and  causes  a  med.um 
amount  of  da  may 
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Move 


Down 


Attack 


Down 


The  Quest 
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The  design:  building  the  form 

The  form  gives  the  game  its  unique  look.  Use  the  form’s 
Backgroundlmage  property  to  display  the  image  of  the  dungeon 
and  the  inventory,  and  a  series  of  PictureBox  controls  to  show 
the  player,  weapons  and  enemies  in  the  dungeon.  You’ll  use  a 
TableLayoutPanel  control  to  display  the  hit  points  for  the  player, 
bat,  ghost  and  ghoul  as  well  as  the  buttons  for  moving  and  attacking. 

The  dungeon  itself  is  a  static  image, 
displayed  using  -the  Backgroundlmage 
property  of  the  form. 


Make  sure  the 


Backgroundlmage  Layo 

property  is  set  to  No 


*  The  Quest 


feiL/was  • 


ZK0BB0 


Left  Rjqht 


Player  playerHitPoint 
Bat  batHitPomts 
Ghost  ghostHrtPoints 
Ghoul  ghoulHitPoints 


Each  of  these  icons  is  a  P ictureBo* 


Wit  points,  movement  buttons,  and 
TableLayoutPanel 


Download  the  background  image  and  tkc  graphics  for  tke 
weapons,  enemies,  and  player  from  tke  Head  First  Labs 
website:  www.keadfirstlaks.com/kooks/kfcskarp 


The  Quest 


Everything  in  the  dungeon  is  a  PictureBox 

Players,  weapons,  and  enemies  should  all  be  represented  by  icons.  Add 
nine  PictureBox  controls,  and  set  their  Visible  properties  to  False.  Then, 
your  game  can  move  around  the  controls,  and  toggle  their  Visible 
properties  as  needed. 


Add  nine  PictureBo*  Controls  to  the 
dungeon  Use  the  Site  property  to 
make  each  one  30*30  It  doesn  t 
matter  where  you  place  them-the 
•form  will  move  them  around  Use  the 
little  black  arrow  that  shows  up  when 
you  Click  on  the  P.ctureBo*  to  set 
each  to  one  of  the  .mages  from  the 
Head  First  Labs  web  site 


After  you've  added  the  nine  PictureBo*  Controls,  ^ _ - 

tnght-didk  on  the  player's  ,Con  and  select  "Br.ng 

to  Front  ,  then  send  the  three  weapon  .Cons  to’^T 

back  hat  ensures  player  .Cons  stay  "above"  any  V 

■terns  that  are  picked  up.  '  ' 

The  inventory  contains  PictureBox  controls,  too 

You  can  represent  the  inventory'  of  the  player  as  five  50x50  PictureBox 
controls.  Set  the  BackColor  property  of  each  to  Transparent.  Since 


Consols  overlap  each  other  ,«  the  IDE, 
the  form  needs  to  know  which  ones  are  ir 
+ront,  and  which  are  in  back.  That's  wha- 
the  Bring  to  Front"  and  “Send  to  Back 
Form  designer  Commands  do. 


the  picture  files  have  a  transparent  background,  you'll  see  the  scroll 


and  dungeon  behind  them: 


Build  your  stats  window 


You’ll  need  five  wore 
<50*50  PictureBo*es 
for  the  inventory 


•  When  the  player  equips  one  of  the  weapons, 
the  form  should  set  the  BorderStyle  of 
that  weapon  icon  to  Fi*edSingle  and  the 
rest  of  the  .Cons’  BorderStyle  to  None 


The  hit  points  are  in  a  Table! -a yout Panel,  just  like  the  attack  and 
movement  buttons.  For  the  hit  points,  create  two  columns  in  the 
panel,  and  drag  the  column  divider  to  the  left  a  bit.  Add  four 
rows,  each  25%  height,  and  add  in  Label  controls  to  each  of  the 


eight  cells: 

2-  Columns,  A"  rows  -- 
9  Cells  for  your  hit 
point  statistics. 


Royer  ployerHilPo.nl 
Bat  betHitPoints 
Gbosi  ghostHiiPomts 
Ghoul  ghouIHrt  Points 


^  has  a  Lab,/ •  ^ 

can  up  dais  l  L 

^  dur.no  lr?  thme 
^  3  the 
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The  architecture:  using  the  objects 

You'll  need  several  types  of  objects  in  your  game:  a  Player 
object,  several  sub-types  of  an  Enemy  object,  and  several  sub- 
types  of  a  Weapon  object.  And  you'll  also  need  one  object  to  keep 
up  with  everything  that’s  going  on:  the  Game  object. 


This  is  just  the  general  overview.  Well  give 
you  a  lot  more  details  on  how  the  player 
and  enemies  move,  how  the  enemy  figures 
out  if  it's  near  the  player,  etc 


fi/ayer& 


The  form  never  interacts 
directly  with  the  players, 
weapons,  or  enemies 


Re  takes  the  input  from 
the  form  and  deals  with  the 
cbjctii  in  the  game. 


f  Move\ 

[  Button  1 
\Cllckedf 


game  .Move  (j 

VVhen  the  user  clicks 
one  of  the  four  move 
buttons,  the  form  calls 
fame’s  MoveO  method 


The  (ra m  object  handles  turns 

When  one  of  your  form’s  Move  buttons  is  clicked,  the  form 
will  call  the  Game  object’s  Move  ( )  method.  That  method 
will  let  the  player  take  a  turn,  and  then  let  all  the  enemies 
move.  So  it’s  up  to  Game  to  handle  the  turn-based  movement 
portion  of  the  game. 

For  example,  here’s  how  the  move  buttons  work: 


There's  only  one  weapon  per  level, 
so  -the  game  just  needs  a  Weapon 
reference,  not  a  List  The  Player, 
however,  has  a  List<Weapon>  to 
hold  the  inventory 


The  tjame  object 
keeps  up  with 
players,  weapons, 
and  a  list  of 
enemies- 


We  left  the  parameters  out  of  this  diagram 
Each  AloveO  method  takes  a  direction,  and 
some  of  them  take  a  Random  object  too 

player .Move  ( )  ^ 


fame’s  MoveO  method  I  i  +. 

first  calls  the  Player 
object's  MoveO  method  to  4?yef  0 
tell  the  player  to  move. 


3.  enemy. Move/ 1 

s  ^ 

After  the  player  moves, 
^Jme  tells  each  of  the 
enemies  to  /VJoveO. 


4.  if  (NearPlayer () ) 

game . HitPlayer ( ) ; 


/ 

*  r  is 


^ |f  any  of  the  encr*»e 
end  up  near  the  player 
after  they've  moved, 
thev  attack  the  player 


^/oyer  0  ^ 
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The  form  delegates  activity  to  the  frame  object 


Movement,  attacking,  and  inventory  all  begin  in  the  form.  So  clicking  a 

movement  or  attack  button,  or  an  item  in  inventory,  triggers  code  in  your 

form.  But  it’s  the  Game  object  that  controls  the  objects  in  the  game.  So 

the  form  has  to  pass  on  anything  that  happens  to  the  Game  object,  and 

then  the  Game  object  takes  it  from  there:  e  /V)oveO  calls  the  enemies’ 

/kJoveO  methods,  which  all 

take  a  random  reference  > 

How  moving  works  .  „ .  / 

.  ...(Direction. Right.  _  V 


'  Move  \ 

|  Button  1 
^Clicked/ 


Use  a  Direction  enum  for 
the  four  button  directions. 

2 .  UpdateCharacters ( ) ; 


When  the  player  hits  an 

enemy,  it  dauses  a  random 
amount  of  damage  (up  to 
a  maiomum  damage  limit) 

i  How  attacking  works 


The  Form  object  calls  the 
game’s  AloveO,  and  then  calls 
its  ou/n  UydateCharacters( ) 
method  to  update  the  screen. 

C  "j 

j^ame  handles  updating 
k  locations,  so  when 

\  ^  pdateCharactersO  « 

1  .  *HS  are  moved 

to  their  new  locations. 

^orneO0^  l 


This  UpdateCharactersO  method  is  part  of  the  < 
form.  |t  reads  the  location  of  the  player,  enemies, 
and  any  weapons  Currently  in  the  dungeon  and 
moves  the  PidtureBoy.es  to  match  them. 


/Attack 
■  Button 
^Clicked 


^CK  (Direction. 


2 .  UpdateCharacters ( ) ; 

The  UpdateCharactersO  method"-^ 
also  checks  the  player’s  inventory 
and  makes  sure  the  Correct  icons  are 
*  displayed  on  the  inventory  scroll. 


How  the  inventory  scroll  works 

check  Player  Inventory  ( ”Bni, 


game . Equip ( "Bow" } ; 


Q 


Attacking  is  like 
movement  •  the 
form  calls  AttackO 
on  ^ame,  and  ^ame 
handles  dealing  with 
the  attack 


V_J> 


The  inventory  scroll  displays  all  of 
the  I Cons  for  the  items  that  the 
player's  picked  up 


■Inventory  - 
^(Clicked*  ^ 


inventoryBow.BorderStyle  = 

BorderStyle . FixedSingle 


Q 


inventor ySword. BorderStyle  = 

BorderStyle .None; 


.  ^bmeo0^ 

ingle; 

The  BorderStyle  property 
Ns-  highlights  the  active  item  in 
the  player's  inventory 
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Building  the  frame  class 


We’ve  gotten  yoti  started  with  the  Game  class  in  the  code  below. 

There’s  a  lot  for  you  to  do — so  read  through  this  code  carefully,  get 
it  into  the  IDE,  and  get  ready  to  go  to  work: 

_ _ You'll  need  the  Rectangle  class  -from 

using  System.  Drawing;  System. Drawing,  so  be  sure  to  add  this 

to  the  top  of  you r  class. 

public  class  Game  (  These  are  okav  as  public  property  if  Enemy  and  Weapon  are 

public  List<Enemy>  Enemies;  ^ \  ^  _ds,  just  make  sure  the  form 

public  Weapon  WeaponlnRoom;  3  ^  ^  ^  Wllh  them 

The  game  keeps  a  private  Player  object  The 
form  will  only  interact  with  this  through 
private  Player  player;  methods  on  game,  rather  than  directly 

public  Point  PlayerLocation  {  get  {  return  player .Location;  }  } 
public  int  PlayerHitPoints  {  get  {  return  player . HitPoints;  }  } 
public  List<string>  PlayerWeapons  (  get  {  return  player .Weapons;  }  } 


private  int  level  =  0; 

public  int  Level  {  get  (  return  level; 


}  } 


private  Rectangle  boundaries; 
public  Rectangle  Boundaries  {  get  {  return  boundaries; 


The  Rectangle  object  has  a  Top,  Bottom, 
Left,  and  Right  f  ield,  and  works  perfectly 
for  the  overall  game  area 


}  I 


public  Game (Rectangle  boundaries) 
this. boundaries  =  boundaries; 
player  =  new  Player (this, 

new  Point (boundaries . Left  +  10, 
boundaries) ; 


$ame  starts  out  with  a  bounding  box  fo 
the  dungeon,  and  creates  a  new  Player 
object  in  the  dungeon 

boundaries .Top  +  70), 


public  void  Move (Direction  direction,  Random  random)  { 
player .Move (direction) ; 
foreach  (Enemy  enemy  in  Enemies)  C- 
enemy. Move (random) ;  j 


public  void  Equip (string  weaponName) 
player .Equip (weaponName) ;  - 


Movement  is  simple:  move  the  player  in  the 
direction  the  form  gives  us,  and  move  each 
enemy  in  a  random  direction. 

These  are  all 


public  bool  CheckPlayerlnventory (string  weaponName) 
return  player .Weapons .Contains (weaponName) j 

) 

public  void  HitPlayer (int  maxDamage,  Random  random) 
player .Hit (maxDamage,  random);  - 

) 


great  examples  of 
encapsulation  £jame 
doesn't  know  how 
Player  handles  these 
actions,  it  just 
passes  on  the  needed 
information  and  lets 
Player  do  the  rest- 
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public  void  IncreasePlayerHealth (int  health.  Random  random)  { 

player .  IncreaseHealth  (health,  random) ;  AttackO  is  almost  exactly  like  W|oveO. 

>  _ "n'e  pbyw  attacks,  and  the  enemies  all 

0et  a  turn  to  move 

public  void  Attack (Direction  direction,  Random  random)  { 
player .Attack (direction,  random) ; 

foreach  (Enemy  enemy  in  Enemies)  AetRandomLoCationO  will  come  in  handy  in 
enemy . Move  (random) ;  ^  KewLevelO  method,  which  will  use  it  to 

determine  where  to  place  enemies  and  weapons 


private  Point  GetRandomLocation (Random  random)  { 
return  new  Point (boundaries. Left  + 

random. Next (boundaries .Right  /  10  -  boundaries. Left 
boundaries .Top  + 

random. Next (boundaries .Bottom  /  10  -  boundaries .Top  / 

This  is  just  a  math  trick  to  jet  a 

...  .  .  . ,  _  i,r>j  ,  ,  ,  random  location  within  the  reC  tangle 

publrc  void  NewLevel (Random  random)  { 

level++  •  that  represents  the  dunjeon  area 

switch  (level)  (  We  only  added  the  case -for 

case  1 :  - -  the  level  I  It’s  your  job  to 

Enemies  =  new  List<Enemy>  ( ) ;  add  cases  for  the  other  levels. 

Enemies .Add (new  Bat  (this,  GetRandomLocation (random) ,  boundaries)); 
WeaponlnRoom  =  new  Sword (this,  GetRandomLocation (random) ) ; 
break; 


Finish  the  rest  of  the  levels 

It's  your  job  to  finish  the  NewLevel  ( )  method.  Here's  the 
breakdown  lor  earh  level: 

Level  Enemies 


Z  ^host 

Z  djhoul 

\  Bat,  £jhost 

5  Bat,  £jhoul 

h  6jhost,  djhoul 

7  Bat,  ^host,  djh  Olil 

e  m 


blue  potion  and  then  the 

&1"  w  Id  ^t  add  a  red  potion  to  the  level 
ja-c  shouldnt  add  a  reap  } 

(and  the  same  jocs^or  the  P 

So  it  the  blue  potion  is 
in  the  player’s  inventory  trom 

_  Level  z,  nothmj  appears  on 

this  level.  ^ 


Weapons 
Blue  potion 
Bow 

Bow,  it  not  picked  up  on  3;  otherwise,  blue  potion 
Red  potion 
Wlace 

Wlace,  it  not  picked  up  on  h,  otherwise,  red  potio*^^  ^-evel  5  has  already 


This  only  appears  it 
the  red  potion  trom 


N/A  -  end  the  jame  with  Application  ExitO 


been  used  up. 
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Finding  common  behavior:  movement 

You  ahead)'  know  that  duplicate  code  is  bad,  and  duplicate  code 
usually  shows  up  when  two  or  more  objects  share  the  same  behavior. 
That's  the  rase  in  the  dungeon  game,  too...  both  enemies  and  players 
move. 

Let’s  create  a  Mover  class,  to  abstract  that  common  behavior  into  a 
single  place.  Player  and  Enemy  will  inherit  from  Mover.  And  even 
though  weapons  don’t  move  around,  they  inherit  from  Mover  too, 
because  they  need  some  of  its  properties  and  methods.  Mover  has 
a  Move  ( )  method  for  moving  around,  and  a  read-only  Location 
property  that  the  form  can  use  to  position  a  subclass  of  Mover. 


a  Direction  enum.  Create  this  enum,  and  give  it  four 
enumerated  values:  Up,  Down,  Left,  and  Right. 
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The  Mover  class  source  code 

Here's  the  code  for  Mover: 

public  abstract  class  Mover  ( 

private  const  int  Movelnterval  =  10; 
protected  Point  location;  < - . 


*****  *t  the  locals  obJ«t 


public  Point  Location  {  get  {  return  location;  }  } 
protected  Game  game; 


public  Mover (Game  game.  Point  location) 
this. game  =  game; 
this . location  =  location; 

) 


object  and  a  Current  location 


public  bool  Nearby (Point  locationToCheck,  int  distance)  ( 
if  (Math. Abs (location. X  -  locationToCheck. X)  <  distance  && 

(Math .Abs (location . Y  -  locationToCheck. Y)  <  distance))  { 
return  true; 

}  else  {  The  Nearbv  method  checks  a  Point  against  this  object's  Current 

return  false;  location.  IT  they're  within  distance  of  each  other,  then  it 

returns  true,  otherwise  it  returns  -false 


Rectangle  boundaries) 


public  Point  Move (Direction  direction. 

Point  newLocation  =  location; 
switch  (direction)  { 
case  Direction. Up: 

if  (newLocation. Y  -  Movelnterval  >=  boundaries . Top) 
newLocation. Y  -=  Movelnterval; 
break; 

case  Direction. Down: 

if  (newLocation . Y  +  Movelnterval  <=  boundaries .Bottom) 
newLocation. Y  +=  Movelnterval; 
break; 

case  Direction. Left: 

if  (newLocation . X  -  Movelnterval  >=  boundaries . Left) 
newLocation. X  -=  Movelnterval; 
break; 

case  Direction. Right: 

if  (newLocation. X  +  Movelnterval  <=  boundaries .Right) 
newLocation . X  +=  Movelnterval; 
break; 

default:  break; 

) 

return  newLocation,’ _  r.  ,  , 

I  ^ —  rmally,  this  new  location  is 

returned  (which  might  still  be  the 
same  as  the  starting  location/). 


{ 

The  /WoveO  method 
tries  to  move  one  step 

,h  a  direction.  If  it 
tan,  it  returns  the 
new  Point  If  it  hits  a 
boundary,  it  returns 
the  original  Point 

|f  the  end  location  is 
outside  the  boundaries, 
the  new  location 
stays  the  same  as  the 
starting  point 
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The  Player  class  keeps  track  of  the  player 


Here’s  a  start  on  the  Player  class.  Start  with  this  code  in 
the  IDE,  and  then  get  ready  to  add  to  it. 


public  class  Player  :  Mover  { 
private  Weapon  equippedWeapon 

private  int  hitPoints; 
public  int  HitPoints  {  get  {  return  hitPoints; 


All  of  the  properties 
f  are  hidden 
+eow  direct  access 


}  } 


private  List<Weapon>  inventory  =  new  List<Weapon> ( ) ; 
public  List<string>  Weapons  { 
get  { 

List<string>  names  =  new  List<string> ( 
foreach  (Weapon  weapon  in  inventory) 
names. Add (weapon. Name) ; 
return  names; 


/(  Player  can  hold 
multiple  weapons  m 
invent**/,  but  °"'7 
on€  dt  3  ti**C 


public  Player (Game  game,  Point 
:  base (game,  location) 
hitPoints  =  10;  - - 


location.  Rectangle  boundaries) 

The  player  s  constructor  sets 
its  hitPoints  to  10  and  then 
Calls  the  base  class  Constructor. 


public  void  Hit (int  maxDamage, 
hitPoints  -=  random. Next (1, 

I 


Random  random) 
maxDamage) ; 


public  void  IncreaseHealth (int  health, 
hitPoints  +=  random. Next (1,  health); 


public  void  Equip (string  weaponName)  { 
foreach  (Weapon  weapon  in  inventory) 
if  (weapon. Name  ==  weaponName) 
equippedWeapon  =  weapon; 


Random  random)  { 


Player  inherits 
-(Von*  Mover,  so 
this  passes  in 
the  ^a»e  and 
location  to  that 
base  class. 

When  an  enemy  hits  the  player, 
it  Causes  a  random  amount  of 
damage  /Ind  when  a  potion 


increases  the  player's  health,  it 
increases  it  by  a  random  amount 


The  EguipO  method  tells  the  player 
to  e<\uip  one  of  his  weapons.  The  £jame 
object  calls  this  method  when  one  of  the 
inventory  icons  is  clicked 


object  equipped  at  a  We- 


Even  though  potions  help  the  player 
rather  than  hurt  the  enemy,  they're 
still  Considered  weapons  by  the  game 
That  way  the  inventory  can  be  a 
List<lVeapon>,  and  the  game  can 
point  to  one  with  its  WeaponlnRoom 
reference 
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Write  the  Moved  method  for  the  Player 

Game  calls  the  Player's  Move  ( )  method  to  tell  a  player  to  move  in 
a  certain  direction.  Move  ( )  takes  in  the  direction  to  move  (using  the 
Direction  enutn  you  should  have  already  added).  Here’s  the  start 
of  that  method: 


This  happens  when  one  of 
•the  movement  buttons  on 
the  -form  is  clicked 


public  void  Move (Direction  direction)  { 

base. location  =  Move (direction,  game. Boundaries) 
if  ( Igame.WeaponlnRoom.PickedUp)  ( 

//  see  if  the  weapon  is  nearby,  and  possibly  pick  it  up 


Move  is  |n  the  Mover 
’base  class. 


) 


} 


COf\ 


When  the  player  picks  up  a  weapon,  it 
needs  to  disappear  from  the  dung, 
and  appear  in  the  inventory 

/ 

TKe  M^pon  and  -form  will  handle 

ir  U  ti  111  1  J  1  making  the  weapon's  P.cturebox 

II  the  weapon  ts  the  only  weapon  the  player  has.  go  ahead  and  invisible  when  the  player  pieks  it  u 

that's  the  job  of  the  Player  [lass. 


You've  got  to  fill  in  the  rest  of  this  method.  Check  and  see  if  the 
weapon  is  near  the  player  (within  a  single  unit  of  distance).  If 
so,  pick  up  the  weapon  and  add  it  to  the  player’s  inventory. 


equip  it  immediately.  That  way.  the  player  can  use  it  right  away, 
on  the  next  turn. 


Add  an  Attack!)  method,  too 


Next  up  is  the  Attack  ( )  method.  This  is  called  when  one  of  the 
form’s  attack  buttons  is  clicked,  and  carries  with  it  a  direction  (again, 
from  the  Direction  enum).  Here’s  the  method  signature: 


The  weapons  all  have  an 
method  that  takes  a 
enum  and  a  Random  object  The 
Player’s  AttackO  will  f  igure  out 
which  weapon  is  equipped  and  call 


its  AttackO 


public  void  Attack (Direction  direction,  Random  random) 
//  Your  code  goes  here 

} 


If  the  player  doesn’t  have  an  equipped  weapon,  this  method 
won’t  do  anything.  If  the  player  does  have  an  equipped  weapon, 
this  should  call  the  weapon’s  Attack  ( )  method. 

But  potions  are  a  special  case.  If  a  potion  is  used,  remove  it 
from  the  player’s  inventory,  since  it’s  not  available  anymore. 

^Pot  ions  will  implement  an  IPotion  interface  (more  on  that 
in  a  minute),  so  you  Can  use  the  "is”  word  to  see  if  a 
Weapon  is  an  implementation  of  IPotion. 


|f  the  weapon  is  a 
potion,  then  AttackO 
removes  it  from  the 
inventory  after  the 
player  drinks  it- 
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Pats,  ghosts,  and  ghouls  inherit  trow  the  Enemy  class 

We’ll  give  you  another  useful  abstract  class:  Enemy.  Each 
different  sort  of  enemy  has  its  own  class  that  inherits  from  the 
Enemy  class.  The  different  kinds  of  enemies  move  in  different 
ways,  so  die  Enemy  abstract  class  leaves  the  Move  method 
as  an  abstract  method  the  three  enemy  classes  will  need  to 
implement  it  differently;  depending  on  how  they  move. 


public  abstract  class  Enemy  :  Mover  { 

private  const  int  NearPlayerDistance  =  25; 
private  int  hitPoints; 

public  int  HitPoints  {  get  {  return  hitPoints; 
public  bool  Dead  {  get  { 

if  (hitPoints  <=  0)  return  true? 
else  return  false; 

} 


Enemy 

(abstract) 


HitPoints:  int 


Move(random:  Random) 
Hit(maxDamage:  int, 
random:  Random) 


.The  form  tan  use  this  read-only 
property  to  see  if  the  enemy  should 
be  visible  in  the  game  dungeon 


Bath  ^ 

subelass 

of  £nen>y 
implements 
this- 


1 

public  Enemy (Game  game.  Point  location.  Rectangle  boundaries,  int  hitPoints) 
:  base (game,  location)  {  this. hitPoints  =  hitPoints;  ) 


public  abstract  void  Move (Random  random); 


public  void  Hit (int  maxDamage, 
hitPoints  -=  random. Next (1, 


When  the  player  attach 
an  enemy,  it  calls  the 
enemy's  HitO  method,  which 
subtracts  a  random  number 
■from  the  hit  points. 

The  ^earPlayerO  method  uses  the  Mover 
NearbyO  static  method  to  figure  out  if 


Random  random) 
maxDamage) ; 


protected  bool  NearPlayer ( )  {  , , 

return  (Nearby  (game.  PlayerLocation, 15  nea’r  P^yer 
NearPlayerDistance) ) ; 


protected  Direction  FindPlayerDirection (Point  playerLocation)  ( 
Direction  directionToMove; 

if  (playerLocation .X  >  location. X  +  10) 
directionToMove  =  Direction. Right; 
else  if  (playerLocation .X  <  location. X  -  10) 
directionToMove  =  Direction. Left; 
else  if  (playerLocation .Y  <  location. Y  -  10) 
directionToMove  =  Direction. Up; 


else 

directionToMove  =  Direction. Down; 
return  directionToMove; 


J 


If  you  feed  FindPlayerDmecW) 
the  player's  location,  it'll  use  the 
base  class’s  location  field  to 
figure  out  where  the  player  is  in 
relation  -to  the  enemy  and  return  a 
Direction  enum  that  tells  you  which 
direction  the  enemy  needs  to  move 
m  order  to  move  towards  the  player. 
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Write  the  different  Enemy  subclasses 

The  three  Enemy  subclasses  are  pretty  straightforward.  Kacli  enemy  has  a 
different  number  of  starting  hit  points,  moves  differently,  and  does  a  different 
amount  of  damage  when  it  attacks.  You'll  need  to  have  each  one  pass  a  different 
startingHitPoints  parameter  to  die  Enemy  base  constructor,  and  you’ll  have 
to  write  different  Move  ( )  methods  for  each  subclass. 

Here’s  an  example  of  how  one  of  those  classes  might  look: 

public  class  Bat  :  Enemy  { 

public  Bat (Game  game.  Point  location.  Rectangle  boundaries) 


base (game,  location,  boundaries, 


{  ) 


.The  bdt  s-tawb  wi-th  t  hit  points,  so  it 
passes  t>  to  the  base  class  Conrtrucfpc 


Y«*  probably  won't  need  any  Constructor  for 
these;  the  base  class  handles  everything 

public  override  void  Move (Random  random)  { 

//  Your  code  will  go  here 

) 

The  bat  flies  around 

somewhat  randomly,  SO  Was  M  more  hit  points, 

it  uses  Random  to  fly  .  On  Kt  d  I  it  any  more.  But 

in  a  random  direction  ^  be  m  ^  ^e's  Enemies  list 

half  the  time-  ^  ^  ^  ^  ?U>w  f  inishes  the  level- 

The  bat  starts  with  6  hit  points.  It’ll  keep  moving  towards  the  player  ) 

and  attacking  as  long  as  it  has  one  or  more  hit  points.  When  it  ' 

_  j  moves,  there’s  a  50%  chance  that  it’ll  move  towards  the  player,  and  a  ^  have  to  make 

Move()  I  50%  chance  dial  it’ll  move  in  a  random  direction.  After  die  bat  moves,  s“re  -the  form 

it  checks  if  it’s  near  the  player  if  it  is,  then  it  attacks  the  player  with  sees  enemy 

_ I  up  to  2  hit  points  of  damage.  should  be  visible 

at  every  turn. 


Each  of  these  subclasses  the 
Enemy  base  class,  which  in  turn 
subclasses  Mover 


Ghost 

7?; 

* 

Move() 

3 

The  ghost  is  harder  to  defeat  than  die  bat,  but  like  the  bat,  it  will  only 
move  and  attack  if  its  hit  points  are  greater  than  zero.  It  starts  with 
8  hit  points.  When  it  moves,  there’s  a  1  in  3  chance  that  it’ll  move 
towards  the  player,  and  a  2  in  3  chance  that  it’ll  stand  still.  If  it’s  near  ybe 

and  ghoul  use 
Random  -to  make 
them  move  more 
slowly  -than  -the 
player. 


the  player,  it  attacks  the  player  widi  up  to  3  hit  points  of  damage. 


'Hie  ghoul  is  the  toughest  enemy.  It  starts  with  10  hit  points,  and  only 
moves  and  attacks  if  its  hit  points  are  greater  than  zero.  When  it  moves, 
there’s  a  2  in  3  chance  that  it’ll  move  towards  the  player,  and  a  I  in  3 
chance  that  it'll  stand  still.  If  it’s  near  the  player,  it  attacks  the  player 
widi  up  to  4  hit  points  of  damage. 
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Weapon  inherits  from  Mover, 

each  weapon  inherits  from  Weapon  {"*■  Mor 

*  *  because  it  uses 

We  need  a  base  Weapon  class,  just  like  we  had  a  base  Enemy  class,  its  NearbyO  and 
And  each  weapon  has  a  location,  as  well  as  a  property  indicating  MoveO  methods  in 
whether  or  not  it's  been  picked  up.  Here’s  the  base  Weapon  class:  Damag eEnemyO 

^ _ J 


Weapon 
(abstract) 

PickedUp 
Location 

PickUpWeapon() 

DamageEnemyO 


public  abstract  class  Weapon  :  Mover 


protected  Game  game; 

private  bool  pickedUp;  £ — 

public  bool  PickedUp  {  get  (  return  pickedUp;  )  } 

private  Point  location;  - - - 

public  Point  Location  {  get  {  return  location;  } 


Point  location)  { 


public  Weapon (Game  game, 

this,  game  =  game;  ~~y  T  , 

this,  location  =  location;  ><r  r  ?  f0™  V*,  se^  3a"*5  ard  l°teb 

pickedUp  =  false;  O  i*!*'  u  l  ***  f,£k<rdWF  ^lse  ^eeaus, 

I  hasn  t  been  picked  up  yet). 


A  pitkedMp  weapon  shouldn't 
be  displayed  anymore  the 
form  tan  use  this  get 
attessor  to  figure  that  out 

^  Every  weapon  has  a  lotatio. 
the  game  dungeon 


r* 

Each 

I 

wcaf  or*  s 
Name 


public  void  PickUpWeapon ( )  {  pickedUp  =  true; 

public  abstract  string  Name  {  get;  )  ^ _ 


Eaeh  weapon  class  needs  to 
implement  a  Name  property  ard  ar 
ft&atkO  method  that  determines 
how  that  weapon  attacks 

public  abstract  void  Attack (Direction  direction.  Random  random); 

Each  weapon  has  a 

1  protected  bool  DamageEnemy  (Direction  direction,  int  radius,  jjffere„t  range  and 

int  damaae.  Random  random)  f  1 1  r 


returns 
its  na»»e 
("Sword" 
"Mace”, 
"Bow”). 


int  damage.  Random  random) 
Point  target  =  game. PlayerLocation; 

for  (int  distance  =  0;  distance  <  radius;  distance++)  { 
foreach  (Enemy  enemy  in  game .Enemies)  { 

if  (Nearby (enemy. Location,  target,  radius))  ( 
enemy. Hit (damage,  random); 
return  true; 

} 


pattern  of  attack,  so 
the  weapons  implement 
the  AttaekO  method 
differently 


1 

target  =  Move (direction,  target,  game. Boundaries ) ;  VP 

j _  r  .  i -  * 


) 

return  false; 


The  DamageEnemyO  method  is  called  by 
AttaekO.  It  attempts  to  find  an  enemy  in 
a  Certain  direction  and  radius.  If  ,t  does,  it 
calls  the  enemy's  HitO  method  and  returns 
true  If  no  enemy's  found,  it  returns  false. 


378 


The  Quest 


Afferent  weapons  attack  in  different  ways 

Each  subclass  of  Weapon  has  its  own  name  and  attack  logistic.  Your  job  is  to 
implement  these  classes.  Here’s  the  basic  skeleton  for  a  Weapon  subclass: 

^ - subclass  represents  one  of  the 

public  class  Sword  :  Weapon  {  three  weapons  a  sword,  b 


public  Sword  (Game  game.  Point  location) _ Each  subclass  relies  on  the  base  class 

:  base  (game,  location)  (  )  ^  to  do  the  initialisation  work. 

Vou’re  basically  hardCoding  in 

public  override  string  Name  {  get  {  return  "Sword";  \  ^ 

public  override  void  Attack (Direction  direction.  Random  random)  ( 

//  Your  code  goes  here 

-n.  i  n  ^a»e  object  will  pass  on 

The  player  can  use  the  the  direct™  to  attack  in. 

weapons  over  and  over— they 
never  get  dropped  or  used  up 


The  sword  is  the  first  weapon  the  player  picks  up.  It's  got  a  wide  angle 
of  attack:  if  lie  attacks  up,  then  it  first  tries  to  attack  an  enemy  that’s  in 


that  direction — if  there’s  no  enemy  there,  it  looks  in  the  direction  that’s 
clockwise  from  the  original  attack  and  attacks  any  enemy  here,  and  if 
it  still  fails  to  hit  then  it  attempts  to  attack  an  enemy  counterclockwise 
from  the  original  direction  of  attack.  It’s  got  a  radius  of  10,  and  causes 
3  points  of  damage. 

The  bow  has  a  very  narrow  angle  of  attack,  but  it’s  got  a  very  long 
range  it’s  got  an  attack  radius  of  30,  but  only  causes  1  point  of 


TKihk  Carefully 
about  -this...  what 


•s  to  the  right 
of  the  direction 
left?  hVKat  is  to 
the  left  of  up? 


damage.  Unlike  the  sword,  which  attacks  in  three  directions  (because 


the  player  swings  it  in  a  wide  arc),  when  the  player  shoots  the  bow  in  a 


direction,  it  only  shoots  in  that  one  direction. 


The  mace  is  the  most  powerful  weapon  in  the  dungeon.  It  doesn’t 
matter  which  direction  the  player  attacks  with  it — since  he  swings  it  in 
a  full  circle,  it’ll  attack  any  enemy  with  a  radius  of  20  and  cause  up  to  6 


points  of  damage. 


I 


The  different  weapons  will  call  DamageEnemyO  in  various  ways.  The 
Mate  attacks  in  all  directions,  so  if  the  player's  attacking  to  the 
right,  it'll  call  Par*>ageEne"<yfDirection  Right,  2-0,  h,  random)  |f 
that  didn't  hit  an  enemy,  it  II  attack  Up  If  there’s  no  enemy  there, 
it'll  try  Left,  then  Down— that  makes  it  swing  in  a  full  circle 
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Potions  implement  the  IPotion  interface 

There  are  tvvo  potions,  a  bine  potion  and  a  red  potion,  which  increase  the 
player’s  health.  They  act  just  like  weapons  the  player  picks  them  up  in 
the  dungeon,  equips  them  by  clicking  on  the  inventory,  and  uses  them 
by  clicking  one  of  the  attack  buttons.  So  it  makes  sense  for  them  to 
inherit  from  the  abstract  Weapon  class. 

But  potions  act  a  little  differently,  too,  so  you'll  need  to  add  an  IPotion 
interface  so  they  can  have  extra  behavior:  increasing  the  player’s  health. 

The  IPotion  interface  is  really  simple.  Potions  only  need  to  add  one  read¬ 
only  property  called  Used  that  returns  false  if  the  player  hasn’t  used  llte 
potion,  and  true  if  he  has.  The  form  will  use  it  to  determine  whether  or 
not  to  display  the  potion  in  the  inventory. 

public  interface  IPotion  { 

bool  Used  {  get;  }  / 

1  ^  ( 

IPotion  makes  Potions  ,  „  ..  ...  ,  , 

usable  only  onde.  It’s  The  potions  inherit  -from  the  Weapon  class  because 

also  possible  to  -find  they're  used  just  like  weapons-the  player  clicks  on 

out  if  a  Weapon  is  a  the  potion  in  the  inventory  scroll  to  e«\uip  it,  and 

potion  with  "if  (weapon  then  clicks  any  of  the  Attack  buttons  to  use  it. 

is  IPotion)  because  o+ 

this  interface  " 


Weapon 

(abstract) 

PickedUp 

Location 

PickUpWeaponf) 

DamageEnemyO 


IPotion 

(Interface) 

Used 


RedPotion 

BluePotion 

Name 

Name 

Attack() 

Attack)) 

You  should  be  able  to 
write  these  classes  using 
this  class  diagram  and 
the  information  below. 


BluePotion 
Name  A 

Attack))  w 


The  BluePotion  class's  Name  property  should  return  the  string 
“Blue  Potion’ .  Its  Attack  ( )  method  will  be  called  when  the  player 
uses  the  blue  potion  it  should  increase  the  player’s  health  by  up  to 
5  hit  points  by  calling  the  IncreasePlayerHealth  ( )  method. 

After  the  player  uses  the  potion,  the  potion’s  Used  ( )  method 

should  return  true.  X.  a.  „  a  blue  potion 

tBssiws- 

fcWePotion  instances 


The  RedPotion  class  is  very  similar  to  BluePotion,  except  that 
its  Name  property  returns  the  string  “Red  Potion”,  and  its  Attack  ( ) 
method  increases  die  players  health  by  up  to  10  hit  points. 
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The  form  brings  it  all  together 

There's  one  instance  of  the  Game  object,  and  it  lives  as  a  private  field  of 
your  form.  It’s  created  in  the  form’s  Load  event,  and  the  various  event 
handlers  in  the  form  use  the  fields  and  methods  on  die  Game  object  to 
keep  the  game  play  going. 

Everything  begins  with  the  form’s  Load  event  handler,  which  passes  the 
Game  a  Rectangle  that  defines  the  boundaries  of  the  dungeon  play 
area.  Here’s  some  form  code  to  get  you  going: 

private  Game  game; 

private  Random  random  =  new  Random (); 
private  void  FormlLoad (object  sender. 

Event Args  e)  { 

game  =  new  Game (new  Rectangle (78,  57,  420, 


a  Retiahjle 

You  II  find  a\oio(  Rectangles  any 
you  work  with  forms.  You 
tan  Create  one  by  passing  it  X  /, 
Mdth,  and  Height  values,  or  two 
Points  (Tor  opposite  Corners).  0nCe 
Y°**  ve  9°t  a  rectangle  instance,  you 
tan  also  access  its  Left,  Right, 

Top,  and  Bottom,  as  well  as  its  X 
Yi  Width,  and  Height  values. 

155)  ); 


game.NewLevel (random) ; 
UpdateCharacters () ; 


-  T  - 

These  are  the  boundaries  of  the 
dungeon  in  the  background  image 
you’ll  download  and  add  to  the  form. 


\zm  w\ 


Remember  to 
double-click  on 
each  PictureB  OX 
so  the  ID 5  adds 
a  separate  event 
handler  method 
for  each  of  them. 


The  form  has  a  separate  event  handler  for  each  of  these  PictureBox’s  Click  events.  When  the 
player  clicks  on  the  sword,  it  fu  st  checks  to  make  sure  the  sword  is  in  the  player’s  inventor)'  using 
the  Game  object’s  CheckPlayerlnventory  ( )  method.  If  the  player’s  holding  the  sword,  the 
form  calls  game  .Equip  ( )  to  equip  it.  It  then  sets  each  PictureBox’s  BorderStyle  property 
to  draw  a  box  around  the  sword,  and  make  sure  none  of  the  other  icons  have  a  box  around  them. 


There’s  an  event  handler  for  each  of  the  four  movement  buttons. 
They’re  pretty  simple.  First  the  button  calls  game .  Move  ( )  with 
the  appropriate  Direction  value,  and  then  it  calls  the  form’s 
UpdateCharacters  ()  method. 

/Wake  sure  you  change  -the  buttons 
back  when  the  player  equips  the 
sword,  bow,  or  mate. 

The  four  attack  button  event  handlers  are  also  really  simple. 

Each  button  calls  game .  At  tack  ( ) ,  and  then  calls  the  form’s 
UpdateCharacters  ( )  method.  If  the  player  equips  a  potion, 
it’s  still  used  the  same  way  by  calling  game  .Attack  ()  but 
potions  have  no  direction.  So  make  the  Left.  Right,  and  Down 
buttons  invisible  when  the  player  equips  a  potion,  and  change  the 
text  on  the  Up  button  to  say  “Drink”. 
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The  form's  UpdateCharactersO  method 
moves  the  PicturePoxes  into  position 

The  last  piece  of  the  puzzle  is  the  form’s  UpdateCharacters  ( ) 
method.  Once  all  the  objects  have  moved  and  acted  on  each  other,  the  form 
updates  everything...  so  weapons  that  been  dropped  have  their  Picture  Boxes’ 
Visible  properties  set  to  false,  enemies  and  players  arc  drawn  in  their  new 
locations  (and  dead  ones  are  made  invisible),  and  inventory  is  updated. 

Here's  what  you  need  to  do: 


O 


Update  the  player's  position  and  stats 

The  first  thing  you’ll  do  is  update  the  player’s  PictureBox  location  and  the  label 
that  shows  his  hit  points.  Then  you’ll  need  a  few  variables  to  determine  whether 
you’ve  shown  each  of  the  various  enemies. 


public  void  UpdateCharactersO  { 

Player . Location  =  game . PlayerLocation; 
playerHitPoints .Text  — 

game . PlayerHitPoints .ToString ( ) ; 


bool  showBat  = 
bool  showGhost 
bool  showGhoul 


false; 

=  false; 
=  false; 


int  enemiesShown 


//  more  code  to  go  here... 


The  show&at  variable  will  be  set  to  true  if 
we  made  the  bat’s  PictureBo*  visible  Same 
ijoes  for  show^jhost  and  showGhoul 


o 


Update  each  enemy’s  location  and  hit  points 

Each  enemy  could  be  in  a  new  location,  and  have  a  different  set  of  hit  points.  You  need  to 
update  each  enemy  after  you’ve  updated  the  player’s  location: 

foreach  (Enemy  enemy  in  game. Enemies)  {  — This  goes  right  after 

if  (enemy  is  Bat)  {  tod«  fro*"  above 

bat. Location  =  enemy. Location; 

batHitPoints.Text  =  enemy .  HitPoints  .ToString  ()  ;  This  will  affect  the 
if  (enemy.  HitPoints  >  0)  {  visibility  of  the  enemy 

showBat  =  true;  _ _  Picture  Bon  controls  in 

enemiesShown++;  just  a  bit- 

You  II  need  two  more  if  statements  like  this 
in  your  foreach  loop-one  for  the  ghost 
and  one  (or  the  ghoul. 
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Once  you’ve  looped  through  all  the  enemies  on  the  level,  check  the  showBat  variable.  If 
the  bat  was  killed,  then  showBat  will  still  he  false,  so  make  its  PictureBox  invisible  and 
clear  its  hit  points  label.  Then  do  the  same  for  showGhost  and  showGhoul. 
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Update  the  weapon  PictureBoxes 

Declare  a  weaponControl  variable  and  use  a  big  switch  statement  to  set  it  equal  to 
the  PictureBox  that  corresponds  to  the  weapon  in  the  room. 

sword. Visible  =  false;  [  Make  sure  your  t°r>'br°ls  r'a"'es 

bow. Visible  =  false;  V  „abth  these  names  It’s  easy  to  cr^ 

redPotion  .Visible  =  false;  'V  wrth  buy  that  are  difftodt  to 
bluePotion .Visible  =  false;  \  tratk  down  if  they  don't  -natch, 
mace. Visible  =  false; 

Control  weaponControl  =  null; 

switch  (game. WeaponlnRoom. Name)  {  you’ll  have  more  eases  for 
case  "Sword" :  <= - 


weaponControl  =  sword;  break; 


each  weapon  type 


The  rest  of  the  cases  should  set  the  variable  weaponControl  to  the  correct  conUol  on 
the  form.  After  the  switch,  set  weaponControl  .Visible  to  true  to  display  it. 

Set  the  Visible  property  on  each  inventory  icon  PictureBox 

Check  use  the  Game  object's  CheckPlayerlnventory  ( )  method  to  figure  out 
whether  or  not  to  display  the  various  inventory  icons. 


Here's  the  rest  of  the  method 

The  first  thing  you’ll  do  is  update  the  player's  PictureBox  location  and  the  label  that 
shows  his  hit  points.  Then  you’ll  need  a  few  variables  to  determine  whether  you’ve 
shown  the  various  enemies. 


Every  level  has  one  weapon  if 
T  it's  been  picked  up,  we  need  to 
make  its  icon  invisible 


weaponControl. Location  =  game. WeaponlnRoom. Location; 
if  (game .WeaponlnRoom. PickedUp) 
weaponControl .Visible  =  false; 

}  else  ( 

weaponControl .Visible  =  true; 

} 

if  (game . PlayerHitPoints  <=  0)  { 

MessageBox . Show ( "You  died" ) ; 

Application. Exit () ; 


} 

if  (enemiesShown  <  1) 

MessageBox . Show ("You  have  defeated  the  enemies  on  this  level"); 
game .NewLevel (random) ;  . 

UpdateCharacter s  ( ) ;  ^  are  "°  mc>rt «**"'**  on 

I  - level,  -then  the  player  s  defeated  them 

all  and  its  time  to  50  to  the  next  level- 


Application  ExrtO  immediately  <\uit.s  the  proyam 
It's  part  of  System Windows  rorms,  so  you  II  need 
the  appropriate  using  statement  if  you  want  to 
use  it  outside  of  a  form 
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The  fun's  just  beginning! 

Seven  levels,  three  enemies...  that’s  a  pretty  decent  game.  Blit  you 
can  make  it  even  better.  Here  are  a  few  ideas  to  get  you  started... 

Make  the  enemies  smarter 

Can  you  figure  out  how  to  change  the  enemies’  Move()  methods  so  that  they’re  harder 
to  defeat?  Then  see  if  you  can  change  their  constants  to  properties,  and  add  way  to 
change  them  in  the  game. 

Add  more  levels 

The  game  doesn’t  have  to  end  after  seven  levels.  See  if  you  can  add  more...  can  you 
figure  out  how  to  make  the  game  go  on  indefinitely?  If  the  player  does  win,  make  a  cool 
ending  animation  with  dancing  ghosts  and  bats!  And  the  game  ends  pretty  abruptly 
if  the  player  dies.  Can  you  think  of  a  more  user-friendly  ending-maybe  let  the  user 
restart  the  game  or  retry  his  last  level. 

Add  different  kinds  of  enemies 

You  don’t  need  to  limit  the  dangers  to  ghouls,  ghosts,  and  bats.  See  if  you  can  add 
more  enemies  to  the  game. 

Add  more  weapons 

The  player  will  definitely  need  more  help  defeating  any  new  enemies  you’ve  added. 

Think  of  new  ways  that  the  weapons  can  attack,  or  different  things  that  potions  can  do. 
Take  advantage  of  the  fact  that  Weapon  is  a  subclass  of  Mover-make  magic  weapons 
the  player  has  to  chase  around! 

Add  more  graphics 

You  can  go  to  www.headfirstlabs.com/books/hfcsharp/  to  find  more  graphics  files 
for  additional  enemies,  weapons,  and  other  images  to  help  spark  your  imagination. 

Tliis  is  your  chance  to  show  oil!  Did  you  come  up  w  ith  a  cool  newT 
version  oJ  the  game?  Join  the  Head  First  C#  Jorum  and  claim  your 
bragging  rights:  www.headJirstlahs.com/hooks/hJcsharp/ 
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Save  the  byte  array,  save  the  world 


Sometimes  it  pays  to  be  a  little  persistent. 

So  far,  all  of  your  programs  have  been  pretty  short-lived.  They  fire  up,  run  for 
a  while,  and  shut  down  But  that’s  not  always  enough,  especially  when  you’re 
dealing  with  important  information.  You  need  to  be  able  to  save  your  work  In 
this  chapter,  we  ll  look  at  how  to  write  data  to  a  file,  and  then  how  to  read  that 
information  back  in  from  a  file.  You'll  leam  about  the  NET  stream  classes, 
and  also  take  a  look  at  the  mysteries  of  hexadecimal  and  binary 


this  is  a  new  chapter 
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islands  in  the  stream 


C*  uses  streams  to  read  and  write  data 

A  stream  is  the  .NET  Framework’s  way  of  getting  data  in  and  out 
of  your  program.  Any  time  your  C#  program  reads  or  writes  a  file, 
connects  to  another  computer  over  a  network,  or  generally  does 
anything  where  it  sends  or  receives  bytes  front  one  place  to 
another,  you’re  using  streams. 


Let’s  say  you  have  a  simple  program — a  form 
with  an  event  handler  that  needs  to  read  data 
from  a  file.  You’ll  use  a  Stream  object  to  do  it. 


Whenever  you 
want  to  read 
data  from  a 
file  or  write 
data  to  a  file, 
you’ll  use  a 
Stream  object. 


input  =  stream. Read () 


rjA  fro mu. 


input  contains  data  read 
from  the  stream  L- 

You  use  3 
Stream  objeti 


"Ht  £*  *****  "*** 

file  directly. 


And  if  your  program  needs  to  write  data  out 
to  the  file,  it  can  use  another  Stream  object. 


stream. Write (output) ; 


"output  contains  datato^^ 


write  to  the  stream 


r9 

You  use  a  different 
stream  object,  but 
tbe  process  is  the 


same 
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Afferent  streams  read  and  write  different  things 


Every  stream  is  a  subclass  of  the  abstract  Stream  class,  and  there  are  a  hunch 
of  built-in  stream  classes  to  do  different  things.  We'll  lie  concentrating  on  reading 
and  writing  regular  files,  but  everything  you  learn  in  this  chapter  will  just  as  easily 
apply  to  compressed  or  encrypted  files,  or  network  streams  that  don’t  use  files  at  all. 


File St reams 
let  you  read  from 
and  w  rite  to  files. 


Memo rySt reams 
let  you  read  from 
and  write  data  to 
chunks  of  memory. 


A  NetworkStream 
object  lets  you  read 
and  write  data  to 
other  computers  or 
devices  on  a  network. 


A  GZipStream 
lets  you  compress 
data  so  that  it  takes 
up  less  space  and  is 
easier  to  download 
and  store. 


Things  you  can  do  with  a  stream: 


o 

o 

o 


Write  to  the  stream. 

You  can  write  text  or  binary  data  to  a  stream  and  through  a  stream's 
Write  ()  method. 

Read  from  the  stream. 

You  can  use  the  Read  ( )  method  to  get  data  from  a  file,  or  a  network, 
or  memory',  or  just  about  anything  else,  using  a  stream. 

Change  your  position  within  the  stream. 

Most  streams  support  a  Seek  ( )  method  that  lets  you  find  a  position 
within  the  stream  so  you  can  insert  data  at  a  specific  place. 


Streams  let  you 
read  and  write 
data.  Use  tke 
right  kind  of 
stream  for  the 
data  you’re 
working  with. 


you  are  here  ► 
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so  much  easier 


A  FileStream  writes  bytes  to  a  file 


When  your  program  needs  to  write  a  few  lines  of  text 
to  a  file,  there  are  a  lot  of  things  that  have  to  happen: 


Create  a  new  FileStream  object  and  tell  it  to  write  to  the  file. 


Make  sure  you  add  usin^  System.  10; 
-to  any  proy-am  that  uses  streams 


Cam  0  f\  FileStream  can  only  be 

attached  to  one  Ale  at  a  time. 


The  FileStream  attaches  itself  to  a  file. 


-O 


'’earn 

o  Streams  write  bytes  to  files,  so  you’ll  need  to  convert  the  string  that  you 
want  to  write  to  an  array  of  bytes. 

69  117  114  101  107  97  33 

..  ,  i„  Eureka! 

This  is  tailed  entodin^,  and  *e 
talk  more  about  «t  later  on 


±±  f  J.X*  1U1  J.UJ  JJ 

lOIOlQininiOlQl 

0  1  Z  3  *  4  4 


o 


o 


Call  the  stream’s  Write  ( )  method 


i  other  programs  can  access  it. 

f 

VytW-  tU“  I’ii  w 
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How  to  write  text  to  a  file  in  $  simple  steps 

C#  comes  w  ith  a  convenient  class  called  StreamWriter  that  does 
all  of  those  things  in  one  easy  step.  All  you  have  to  do  is  create  a  new 
StreamWriter  object  and  give  it  a  filename.  It  automatically  creates  a 
FileStream  and  links  it  to  the  file.  Then  you  can  use  the  Stream Writer’s 
W rite  ( )  and  WriteLine  ()  methods  to  write  everything  to  the  file  you 
want. 


StreamWriter 
creates  and 
manages  a 
FileStream 
object  for  you 
automatically. 


Use  the  StreamWriter’s  constructor  to  open  or  create  a  file 

You  can  pass  a  filename  to  the  StreamWriter  ( )  constructor.  When  you  do,  the  writer  automatically 
opens  the  file.  StreamWriter  also  has  an  overloaded  constructor  that  also  takes  a  bool:  true  if  you 
want  to  add  text  to  the  end  of  an  existing  file  (or  append),  or  false  if  you  want  to  delete  the  existing  file 
and  create  a  new  file  with  the  same  name. 


StreamWriter  writer  =  new  StreamWriter (@"C: \newfiles\toaster  oven.txt",  true); 

- ? 


Putting  ®  m 

filename  tells  C#  to  treat 

iw,s  as  a  literal  stritty  without 
escape  characters,  like  't  tor 
tab  cfc  for  newline 


Use  the  Write()  and  WriteLine()  methods  to  write  to  the  file 

These  methods  work  just  like  the  ones  in  Console  :  Write  ( )  writes  text,  and  WriteLine  ( )  writes 
text  and  adds  a  line  break  to  the  end.  If  you  include  “{0}”,  “{ 1 “{2}”,  etc.,  inside  the  string  you’re 
writing,  the  methods  include  parameters  in  the  strings  being  written:  “{0}”  is  replaced  with  the  first 
parameter  after  the  string  being  written,  “{ 1 }”  is  replaced  with  the  second,  etc. 

writer .WriteLine ("The  (0)  is  set  to  (1)  degrees.",  appliance,  temp.ToString () ) ; 


Call  the  Close()  method  to  release  the  file 

If  you  leave  die  stream  open  and  attached  to  a  file,  then  it'll  keep  the  file  locked  open 
and  no  other  program  will  he  able  to  use  it.  So  make  sure  you  always  close  your  files! 


writer . Close  ( ) ; 


you  are  here  ► 
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The  Swindler  launches  another  diabolical  plan 


The  citizens  of  Objectville  have  long  lived  in  fear  of  the  Swindler. 

Now  lie’s  using  a  StreamWriter  to  implement  another  evil  plan. 

Let's  take  a  look  at  what’s  going  on: 

The  path  starts  with  a*  §  si9n  so 

This  line  creates  the  StreamWriter  object  a*d  that  the  StreamWriter  doesn't 

_  WU  ,t  «k«  *e  file  kc  tier  "\  *  t|*  Hlrt  of 

f  e$cape  sequence 


C* 


s 

StreamWriter  sw  =  new  StreamWriter (@"c : \secret_plan . txt") ; 
sw .WriteLine ("How  I'll  defeat  Captain  Amazing"); 


WriteL'meO  sw.  WriteLine  ("Another  genius  secret  plan  by  The  Swindler"); 

adds  a  new  Ime  sw.write_("I' 11  create  an  army  of  clones  and  ")  ; 
a-fter  writing 

WriteO  sends  sw  .WriteLine  ("unleash  them  upon  the  citizens  of  Objectville."); 

\ust  the  te’sti  ^ _  />,  c  , 

J  .1,  i,  string  location  =  "the  mall";  ^  '  Can  you  figure  out  what s 

ime  veeai  dv  for  (int  number  =  0;  number  <=  6;  number++)  (  liable  in  this  code? 
the  end 

sw. WriteLine ("Clone  #{0}  attacks  {1}",  number,  location); 
if  (location  =  "the  mall")  {  location  =  "downtown";  } 


> 

sw 


else  {  location  =  "the  mall";  } 

- CloseO  Trees  up  any  Connections  to  the 

.  Close  ( )  ;  -f  ile  and  any  resources  0>e  StreamWriter  » 
using  The  text  doesnt  get  written  .T  you 
don't  close  the  stream 


Vou  can  use  the  {} 
within  the  text  to 
pass  in  variables  to  the 
string  being  written 
{0}  U  replaced  by  the 
Tirst  parameter  aTter 
the  string  {/}  by  the 
second,  and  so  on 


This  is  what  the 
Code  above  produces 


|  Fie  Edit  Format  View  Hep 

Another  genius  secret  plan  by  The  Swindler 

I'll  create  an  army  of  clones  and  unleash  them  upon  the  citizens  of  Objectville. 

Clone  #0  attacks  tne  mall 

Clone  #1  attacks  downtown 

Iclone  #2  attacks  the  mall 

Clone  #3  attacks  downtown 

Clone  #4  attacks  the  mall 

Clone  #5  attacks  downtown 

Clone  #6  attacks  the  mall 
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Stream  Writer  Magnets  I  ZaP  = 

O  return  tirue ; 

Suppose  you  have  the  code  for  button  1_Click()  shown  below. 

Your  job  is  to  use  the  magnets  to  build  code  for  the  Flobbo 
class  so  that,  when  the  event  handler  is  called,  it  produces  the 
output  shown  at  the  bottom  of  the  page.  Good  luck! 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 
Flobbo  f  =  new  Flobbo ("blue  yellow"); 

StreamWriter  sw  =  f.Snobbo(); 
f . Blobbo (f .Blobbo (f . Blobbo (sw) ,  sw) ,  sw) ; 


r .WriteLine (Zap) • 
=  "red  orange" 


sw .WriteLine (Zap) ; 
sw. Close () ; 
return  false ; 


public  bool  Blobb^™ 

(bool  Already,  StreamWriter  sw)  { 


public  bool  Blobbo (StreamWriteT 

sw .  WriteLine  (Zap)  ; 

Zap  =  "green  purple"; 

. - ,  return  false; 

0^ 

I  return  new 

StreamWriter ("macaw . txt  ) , 


sw)  { 


0 


0 


private  string  Zap; 

public  Flobbo (string  Zap)  { 
this . Zap  =  Zap ; 


public 


class  Flobbo  { 


if  (Already)  ( 


)  else  { 


public  StreamWriter  Snobbo()  { 


Output: 


macaw  txt  *  Notepad 


Fte  Edit  Format  View  Hep 

blue  yellow 
green  purple 
red  orange 


you  are  here  ► 


read  it  in 


StrearnWriter  Magnets  Solution 

Your  job  was  to  construct  the  Flobbo  class  from  the  magnets 
to  create  the  desired  output. 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 
Flobbo  f  =  new  Flobbo ( "blue  yellow" ) ; 

StrearnWriter  sw  =  f.Snobbof); 
f . Blobbo (f . Blobbo (f . Blobbo (sw) ,  sw) ,  sw) ; 


public  class  Flobbo  { 

1 _ 

private  string  Zap; 

public  Flobbo (string  Zap)  { 
this . Zap  =  Zap ; 

) 

The  BlobboO  method 
is  overloaded— it  s  got 
■two  declarations  With 
dt-Werent  parameters. 


Make  sure  70U  tlose 
(i)es  when  7°ure  dor>e 

with  them. 

Output; 


■aittiTak 

File  Edt  Format  View 

Hep 

blue  yellow 
green  purple 

red  orange 

— J 
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Reading  and  writing  takes  two  objects 

Let's  read  Swindler’s  secret  plans  with  another  stream,  a  StreamReader. 

StreamReader  works  just  like  a  StreamWriter,  except  instead  of  writing 
a  file  you  give  the  reader  the  name  of  the  file  to  read  in  its  constructor.  The 
ReadLine  ()  method  returns  a  string  that  contains  the  next  line  from  the  file. 

You  can  write  a  loop  that  reads  lines  from  it  until  its  EndOf  Stream  field  is 
true  that’s  when  it  runs  out  of  lines  to  read: 

_ _ _  Pass  the  file  you  want 

StreamReader  reader  =  ^  ^  ^  W  ^  #,« 

new  StreamReader  (@ "d :  \secret_j?lan .  txt")  ;  StreamReader  s  tonstrvttor 
StreamWriter  writer  = 


new  StreamWriter (@"e : \emailToCaptainAmazing . txt") ; 

This  program  uses  a  StreamReader  to  read  the 
Swindler  s  plan,  and  a  StreamWriter  to  write  a  file 
that  will  jet  emailed  to  Captain  Amaz-inj. 
writer . WriteLine ("To :  CaptainAmazing@objectville.net") ; 

writer .WriteLine ("From:  Commissioner@objectiville.net") ; 


writer . WriteLine ("Subject:  Can  you  save  the  day...  again?"); 

writer  .WriteLine  ()  ;  ^ _ -  A*  ^'tcLineO  method 

\  writes  a  blank  line' 

writer .WriteLine ("We' ve  discovered  the  Swindler's  plan:"); 

while  ( ! reader . EndOf Stream)  {  — - — _ 

string  lineFromThePlan  =  reader .ReadLine  ()  ; 
writer .WriteLine ("The  plan  ->  "  +  lineFromThePlan); 


end0^t«am  is  the  r  ^ 

that  tells 'you. ^  ( 

data  left  unvead  -  the 


} 

writer . WriteLine () ; 

writer . WriteLine ("Can  you  help  us?"); 


the  reader  and  writes  it 
to  the  writer. 


writer .  Close  ()  ; 


reader . Close ( ) ; 


Make  sure  to  close  every 
stream  that  you  open,  even  >+ 
youVe  just,  readmj  a  file- 


1  Re  rdt  Fermat  view  M*. 

To:  CaptaunAirazmcFflcbiectvlle.net 

Frytn:  ooverncrflcbject iv llle.net 
subject:  can  you  save  the  day...  agaln7 

fce've  discovered  the  Swirxi  er  5  plan: 

The  plan  ->  how  T  11  defeat  captain  Amazing 

The  plan  ->  Another  gen-ius  serrpr  .Van  hy  Toe  SwincW 

The  plan  ->  I'll  create  art  amy  of  clones  and  jnlaasn  tnem  tpsr  the  citizers  cf  CbjectviUe 

The  plan  ->  Clone  #0  attacks  tne  ma*l 

The  plan  >  Clone  #1  attacks  downtown 

The  plan  >  Clone  #2  attacks  the  ma' 1 

The  plan  ->  Clone  A3  attacks  doaitown 

The  plan  ->  clone  #4  attacks  the  ma‘1 

the  plan  ->  clone  #5  attacks  downtown 

The  plan  ->  Clone  #0  attacks  the  ma  I 

Can  you  help  us? 

111  1  ■  1,111  1  11  11  1 


you  are  here  ► 
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don’t  cross  the  streams 


Pata  can  go  through  more  than  one  stream 

( )n<-  big  advantage  to  working  with  streams  in  .NE  T  is  that  you  can  have  your  data 
go  through  more  than  one  stream  on  its  way  to  its  final  destination.  One  of  the  many 
types  of  streams  that  .NET  ships  with  is  the  CryptoStream  class.  This  lets  you 
encrypt  your  data  before  you  do  anything  else  with  it: 


AN. 


< 

Q 


Usin*  a  normal  P.leStream,  vo«r  data 
yts  bitten  directly  to  a  Tie  as  tent 


'rea(^ 1 


I 


w-ite  normal 
Wioa 

CryptoStream. 


Z2XA- 

-cstss 


CryptoStream  inherits 
•from  the  abstract 

Stream  class,  just 
like  the  other  stream 
classes. 


C'SYreo^ 


You  can  CHAIM  streams.  One  stream 
can  write  to  anotlier  stream,  which 
writes  to  another  stream...  often 
enJing  with  a  network  or  file  stream. 
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Poo]  Puzzje 


Your  job  is  to  take  code  snippets  from 
the  pool  and  place  them  into  the 
blank  lines  in  the  program.  You 
can  use  the  same  snippet  more 
than  once,  and  you  won’t  need 
to  use  all  the  snippets.  Your  goal 
is  to  make  the  program  produce 
the  output  shown  to  the  right. 

public  class  Pineapple  { 

const  _  d  =  "delivery.txt"; 

public  _  _ 

(  North,  South,  East,  West,  Flamingo  ) 
public  static  void  Main()  { 


He  Edit  Format  View  Help 

West 

East 

South 

North 

That's  all  folks! 


public  class  Pizza  { 

private  _ 

public  Pizza  ( _ 


o  =  new 


Pizza  pz  =  new  Pizza (new 


("order . txt") ; 
_ (d,  true) ) 


for  ( 


_( Fargo. Flamingo) ; 
w  =  3;  w  >=  0;  w — )  { 


Pizza  i  =  new  Pizza 

(new  _ 

i . Idaho ( (Fargo) w) ; 

Party  p  =  new  Party (new 


.(d,  false) ) ; 


•Writer  =  Writer; 


public  void 
Writer. _ 


Writer. 


.( _ .Fargo  f)  ( 

.(f  .ToString  () )  ; 


public  class  Party  { 
private  _ 


Reader; 


public  Party  (_ 


Reader)  { 


.Reader  =  Reader; 


("That's  all  folks!"); 


public  void  HowMuch  (_ 


(Reader. 


Reader. 


HowMany 

HowMuch 

HowBig 

HowSmall 


Stream 

Reader 

Writer 

StreamReader 

StreamWriter 

Open 

Close 


public 

private 

this 

class 

static 


for 

while 

foreach 


Fargo 

Utah 

Idaho 

Dakota 

Pineapple 


a  serious  dialog 


poo]  puzz]c  §o]ution 


P1*  is  used  with  its 


Here's  the  entry  S* 
ikg  proAva^  l*t  Creates  a 

tL  Party  lUss  Tto.  *  l~r 

tw~ik  tte  F*£  -'fTl 
gaSSo-Mkr^ 


public  class  Pineapple  { 

const  string  d  =  "delivery.txt"; 
public  enum  Fargo  {  North,  South,  East,  West,  Flamingo  } 
public  static  void  Main()  { 

^  StreamWriter  o  =  new  StreamWriter  ("order.txt")  ; 

V.  Pizza  pz  =  new  Pizza  (new  StreamWriter  (d,  true)); 

)  pz. Idaho (Fargo. Flamingo) ; 

)  for  (int  w  =  3;  w  >=  0;  w — )  { 


, 


Pizza  i  =  new  Pizza (new 
i . Idaho ( (Fargo) w) ; 

Party  p  =  new  Party (new 

p .  HowMuch  (o) ; 


StreamWriter  (d,  false) ) 
StreamReader  (d) )  ; 


o.  Writeline  (' 
.Close  ( )  ; 


That's  all  folks!") 


) 


kr 


public  class  Pizza  ( 

private  StreamWriter  Writer; 
public  Pizza  (StreamWriter  Writer)  ( 
this. Writer  =  Writer; 

) 

public  void  Idaho ( Pineapple. Fargo  f) 
Writer  .WriteLine  i  f  .ToString  ()  )  ; 
Writer  .Close  () ; 

) 


-pi  PlXXa  tUss  kee?^ 

.-l  ^  a  wivaU 


Z  MahoO 

(»e\d,  1  ^  the 

tie  ^ 

method 


public  class  Party  { 


The  Party  class  has  a 
StreamReader  -field,  and 
its  HowAludhO  method 
reads  a  line  -from  that 
StreamReader  and  writes 
it  to  a  StreamlfVriter. 


private  StreamReader  Reader; 
public  Party (StreamReader  Reader)  ( 
this  •Reader  =  Reader; 

) 

public  void  HowMuch  (StreamWriter  q) 

a .  WriteLine  (Reader .  ReadLine  ( ) )  ; 

Reader  .Close  ( ) ; 

) 
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Use  built-in  objects  to  pop  up  standard  dialog  boxes 

When  you’re  working  on  a  program  that  reads  and  writes  files,  there’s 
a  good  chance  that  you’ll  need  to  pop  up  a  dialog  box  at  some  point  to 


ShowPialogO  pops  up  a  dialog  box 

Displaying  a  dialog  box  is  easy.  Here's  all  you 
need  to  do: 


We  II  walk  you  -tkirougk 
these  steps  i„  a 


Create  an  instance  of  the  dialog  box  object.  You  can  do  this  in  code 
using  new.  or  you  can  drag  it  onto  your  form  out  of  the  toolbox. 


Set  the  dialog  box  object’s  properties.  A  few  useful  ones  include  Title  (which 
sets  the  text  in  the  title  bar),  InitialDi  rectory  (which  tells  it  which 
directory  to  open  first),  and  FileName  (lor  open  and  save  dialog  boxes). 


Call  the  object's  ShowDialog  ( )  method.  That  pops  up  the  dialog  box. 
and  doesn’t  return  until  the  user  clicks  the  OK  button  or  the  Cancel 
button,  or  closes  the  window. 


The  ShowDialog  ( )  method  returns  a  DialogResult,  which  is  an  enum. 
Some  of  its  members  are  OK  (which  means  the  user  clicked  OK),  Cancel,  Yes, 
and  No  (for  Yes/No  dialog  Ixixes). 


you  are  here  ► 
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dialog  boxes  are  objects  too 


Pialog  boxes  are  just  another  .NET  control 


ua^  au  v/pem  j.xeuxaxu<^  luiiuuj  uuiui  uic  iuuiuua  auu  ^  p  i  i - 

:cad  of  showing  up  as  a  visual  control,  you'll  see  it  appear  in  (  °^m  *^Cri  7°“  i 

n.  That’s  because  it’s  a  component,  which  is  a  special  kind  <x‘^'  the  'toolbox. 


You  can  add  Windows  standard  file  dialog  boxes  to  your  program  just  by  dragging 
them  to  your  form  -just  drag  an  OpenFileDialog  control  out  of  the  toolbox  and 
chop  it  on  your  form.  Inste 

the  space  below  your  form.  Tliat’s  because  it’s  a  component,  which  is  a  special 
of  non-visual  Toolbox  control  that  doesn’t  appear  directly  on  the  form,  but  which 
you  can  still  use  in  your  form's  code  just  like  you  use  any  other  control. 

&  Dialogs 

1^  Pointer 
jul  ColorDiatog 
SI  FolderBrowser Dialog 
a*|  FontDiakg 


Non- visual”  just  means 

it  doesn't  appear  Oh  your 

rt 


When  you  drag  a  Component  out  of  the 
Toolbox  and  onto  your  form,  the  IDF 
displays  rt  in  the  space  underneath  the 
•form  editor. 


The  InitialPirectory  propery  changes  the  folder^ 
thats  first  displayed  when  the  dialog  opens. 


X/ 


openFileDialogl . InitialDirectory  =  @"c: \MyFolder\Default\"; 
openFileDialogl .Filter  =  "Text  Files  (* .txt)  I  * .txt | "  ^ 

+  "Comma -Delimited  Files  (* . csv)  | * ,csv I  All  Files  (*. *)!*•*' 


Fhe  Filter 
property  lets  you 
the  filters 
that  show  up  on 
the  bottom  of  the 
dialog  box,  such  as 

types  of  files 
to  show. 


openFileDialogl .CheckFileExists  =  true; 


openFileDialogl . FileName  =  "default  file.txt"; 

to  display  an  error  message  *  the^ 

openFileDialogl  .CheckPathExists  =  false;  \  user  tries  to  open  up  a  J 

— i  that  doesn  t  exist  on  the  dr.ve 

DialogResult  result  =  openFileDialogl . ShowDialog () ; 
if  (result  =  DialogResult .OK) { 

OpenSomeFile (openFileDialogl . FileName) ; 

1  t  *"****>  3 

„  J M uL OKkAt  U  £h«k  *k«Uw  «•  »ot  ihe 
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dialog  boxes  are  objects,  too 

An  OpenFileDialog  box  object  shows  the  standard  Windows  “Open” 
window,  and  the  SaveFileDialog  shows  its  “Save”  window.  You  can  display 
them  by  creating  a  new  instance,  setting  the  properties  on  the  object,  and 
calling  its  ShowDialog  ( )  method.  The  ShowDialog  ( )  method  returns 
a  DialogResult  enum  (because  some  dialog  boxes  have  more  than  two 

buttons  or  results,  so  a  simple  bool  wouldn’t  he  enough).  When  you  draj  a  save  dialog  object  out 

- - - o£  the  toolbox  and  onto  your  form,  the 

, ,  IDE  just  adds  a  line  like  this  to  your 

saveFileDialogl  -  new  SaveFileDialogl);  W. 

saveFileDialogl . InitialDirectory  =  @"c: \MyFolder\Default\"; 

saveFileDialogl . Filter  =  "Text  Files  (* . txt) | * . txt | " 

+  "Comma-Delimited  Files  (* .csv) | * .csv I  All  Files  (*.*)!*.*"; 

DialogResult  result  =  saveFileDialogl . ShowDialog ( ) ; 

if  (result  ==  DialogResult .OK) 1  TVie  SWjW-iP  ~ 

\C-  I .  i,  »*adtW  the  same 

SaveTheFile  (saveFileDialogl .  FileName)  ;  yr q  T  |eD<alo$  object 

The  SaveFileDialog 
object  pops  up  the 
standard  Windows 
Save  as.,  dialog  box. 


r 

The  Title  property  lets 
you  change  this  text 


The  ShowDialogO 

method  pops  up 
the  dialog  box 
^d  opens  the 
•folder  specified 

J.L  _  I  .  I  .  . 


Plaasa  s«l«ci  tha  ffla  you  want  to  sava 


|  U  VHlo*  studio  MW 


the  InitialFolder 
Property. 


m 


kj&3>  f^m. 

Lite  Jc  Sff:pCG 

LjProjects 

usettr^s 

LjTeinpdl'A 

LjVljui^ri 


Change  the  “Save  as 
type’  list  usin^  the 
Filter  property 


Jl  •  0- 


WJhen  the  user  chooses  a 
•hie,  'ts  is  %dved 

tKe  ' 'leA/ame  property. 


The  D'S'o^esult 

returned  by  the 

ShowDialog)  method 
.  lets  you  £  'Ve 
vaWiCh  button  the 
user  clicked- 
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directory  assistance 


Use  the  built-in  File  and  directory  classes 
to  work  with  files  and  directories 

Like  StreamWriter,  the  File  class  creates  streams  for  you  to  work  with  Hies  behind  the 
scenes.  You  can  use  its  methods  to  do  most  common  actions  without  having  to  create  the 
FileStreams  first.  Directory  objects  let  you  work  with  whole  directories  full  of  files, 
you  can  use  it  to  make  changes  to  your  file  structure  easily. 


Things  you  can  do  with  a  File: 


Find  out  if  it  exists 

You  can  check  to  see  if  a  file  exists  using  the 
Exists  ()  method.  It'll  return  true  if  it  does 
and  false  if  it  doesn’t. 


Read  from  and  write  to  the  file 

You  can  use  the  OpenRead  ( )  method  to  get  data 
from  a  file,  or  the  Create  ( )  or  OpenWrite  ( ) 
method  to  write  to  the  file. 


Append  text  to  the  file 

The  AppendAl  lText  ( )  method  lets  you  append 
text  to  an  already  created  file.  It  even  creates  the  file 
if  it’s  not  there  when  the  method  runs. 


Set  information  about  the  file 

The  GetLastAccessTime  ( )  and 
GetLastWriteTime  ()  methods  return 
the  date  and  time  when  the  file  was  last 
accessed  and  modified. 


Filc/n-fo  works  just  like  File 

you’re  going  io  be  domg  a  lot  of  work  with 
a  Lie,  you  .mght  want  to  create  an  instance  of 
tbe  F.lelnfo  class  instead  of  using  the  File  class’s 
static  methods. 

The  Filelnfo  Class  does  just  about  everything  the 
hie  class  does  except  you  have  to  instantiate 
>t  to  use  it-  /ou  can  create  a  new  instance  of 
hlelnto  and  access  its  Exists  ()  method,  or 
•ts  OpenRead  ()  method  in  just  the  same  way. 

The  only  difference  is  that  the  File  class  is 
taster  for  a  small  number  of  actions  and  Filelnfo 
's  better  suited  tor  big  jobs. 


Things  you  can  do  with  a  Pirectory: 


Create  a  new  directory 

Create  a  directory'  using  the  CreateDirectory  ( )  method.  All 
you  have  to  do  is  supply  the  path;  this  method  does  the  rest. 


Get  a  list  of  the  files  in  a  directory 

You  can  create  an  array  of  files  in  a  directory  using  the 
GetFiles  ( )  method;  just  tell  the  method  which  directory  you 
want  to  know  about  and  it  will  do  the  rest. 


Delete  a  directory 

Deleting  a  directory  is  really  simple  too.  Lise  the  Delete  ( )  method. 
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there jure  no 

Dumb  Questions 


Oj 

I  still  don't  get  that  {0}  and  {1}  thing  that  was  part  of  the 
StreamWriter. 

A. 

When  you're  printing  strings  to  a  file,  you'll  often  find  yourself  in 
the  position  of  having  to  print  the  contents  of  a  bunch  of  variables.  For 
example,  you  might  have  to  write  something  like  this: 

writer .WriteLine ("My  name  is  "  +  name  + 
"and  my  age  is  "  +  age) ; 

It  gets  really  tedious  and  somewhat  error-prone  to  have  to  keep  using 
+  to  combine  strings  It's  easier  to  take  advantage  of  {0}  and  {1}: 

writer .WriteLine ( 

"My  name  is  (0)  and  my  age  is  (1}"/ 
name,  age) ; 

It's  a  lot  easier  to  read  that  code,  especially  when  many  variables  are 
included  in  the  same  line. 

Qj  Why  did  you  put  a  @  in  front  of  the  string  that  contained 
the  filename? 

The  Write  ( )  and  WriteLine  ( )  methods  support 
escape  sequences  like  \n  and  \r  That  makes  it  difficult  to  type 
filenames,  which  have  a  lot  of  backslash  characters  in  them.  If  you  put 
@  in  front  of  a  string,  it  tells  C#  not  to  interpret  escape  sequences.  It 
also  tells  C#  to  include  line  breaks  in  your  string,  so  you  can  hit  Enter 
halfway  through  the  string  and  it'll  include  that  as  a  linebreak  in  the 
output: 

string  twoLine  =  @”this  is  a  string 
that  spans  two  lines.”; 

o 

And  what  do  \n  and  \t  mean  again? 

Those  are  escape  sequences,  \n  is  a  linefeed  and  \t  is  a  tab 
\r  is  a  return  character,  or  half  of  a  Windows  return— in  Windows 
text  files,  lines  have  to  end  with  \r \n.  If  you  want  to  use  an  actual 
backslash  in  your  string,  and  not  have  C#  interpret  it  as  the  beginning 
of  an  escape  sequence,  just  do  a  double  backslash:  \  \  . 

o 

V.  What  was  that  in  the  beginning  about  converting  a  string  to 
a  byte  array?  How  would  that  even  work? 


You've  probably  heard  many  times  that  files  on  a  disk  are 
repesented  as  bits  and  bytes.  What  that  means  is  that  when  you  write 
a  file  to  a  disk,  the  operating  system  treats  it  as  one  long  sequence 
of  bytes  Remember  from  Chapter  4  how  a  byte  variable  can  store 
any  number  between  0  and  255?  Every  file  on  your  hard  drive  is  one 
long  sequence  of  numbers  between  0  and  255.  It's  up  to  the  programs 
that  read  and  write  those  files  to  interpret  those  bytes  as  meaningful 
data  When  you  open  a  file  in  Notepad,  it  converts  each  individal 
byte  to  a  character— for  example,  E  is  69  and  a  is  97.  And  when 
you  type  text  into  Notepad  and  save  it,  Notepad  converts  each  of  the 
characters  back  into  a  byte  and  saves  it  to  disk.  And  if  you  want  to 
write  a  string  to  a  stream,  you'll  need  to  do  the  same. 

Q  I  If  I'm  just  using  a  StreamWriter  to  write  to  a  file,  why  do  I 
realty  care  if  it's  creating  a  FileStream  for  me? 

A. 

•rV*  If  you're  only  reading  or  writing  lines  to  or  from  a  text  file  in  order, 
then  all  you  need  are  StreamReader  and  StreamWriter. 
But  as  soon  as  you  need  to  do  anything  more  complex  than  that, 
you’ll  need  to  start  working  with  other  streams.  If  you  ever  need  to 
write  data  like  numbers,  arrays,  collections  or  objects  to  a  file,  a 
StreamWriter  just  won’t  do.  But  don’t  worry,  we'll  go  into  a  lot 
more  detail  about  how  that  will  work  in  just  a  minute. 

O  1  What  if  I  want  to  create  my  own  dialog  boxes?  Can  I  do 
that? 

A- 

•rV  Yes,  you  definitely  can  You  can  add  a  new  form  to  your 
project,  design  it  to  look  exactly  how  you  want.  Then  you  can 
create  a  new  instance  of  it  with  new  (just  like  you  created 
an  OpenFileDialog  object).  Then  you  can  call  its 
ShowDialog  ( )  method,  and  it'll  work  just  like  any  other  dialog 
box.  We  ll  talk  a  lot  more  about  adding  other  forms  to  your  program  in 
Chapter  13. 

Q  1  Why  do  I  need  to  worry  about  closing  streams  after  I'm 
done  with  them? 

A- 

•rV  Have  you  ever  had  a  word  processor  tell  you  it  couldn’t  open  a 
file  because  it  was  "busy’?  When  one  program  uses  a  file,  Windows 
locks  it  and  prevents  other  programs  from  using  it,  And  it’ll  do  that  for 
your  program  when  it  opens  a  file.  If  you  don’t  call  the  Close  ( ) 
method,  then  it's  possible  for  your  program  to  keep  a  file  locked  open 
until  it  ends. 
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do  it  yourself  notepad 


parpen  your  pencil 


.NET  has  two  built-in  classes  with  a  bunch  of  static  methods  for  working 
with  files  and  folders.  The  File  class  gives  methods  to  work  with  files, 
and  the  Directory  class  lets  you  work  with  directories.  Write  down 
what  you  think  each  of  these  lines  of  code  does. 


What  the  code  does 


if  (Directory. Exists(@”c:\SYP") )  { 

Directory. CreateDirectory (0"c: \SYP") ; 

} 


if  (Directory. Exists (0”c: \SYP\Bonk") )  { 
Directory . Delete (@"c:\SYP\Bonk") ; 

} 


Directory. CreateDirectory (@"c: \SYP\Bonk") ; 


Directory. SetCreationTime (@"c: \SYP\Bonk", 
new  DateTime ( 1976,  09,  25)); 


string []  files  =  Directory. GetFiles (0"c: \windows\", 
"* .log",  SearchOption.AllDi rectories) ; 


File . WriteAllText (@"c: \SYP\Bonk\weirdo.txt", 
0"This  is  the  first  line 
and  this  is  the  second  line 
and  this  is  the  last  line"); 


File. Encrypt (@"c:\SYP\Bonk\weirdo.txt") ; 


A  See  i-f  you  tan  ^uess  what  thi 

does— you  haven  t  seen  it  yet 


this  one 


File . Copy ( @”c : \SYP\Bonk\weirdo . txt " , 
@"c: \5YP\copy.txt") ; 


DateTime  myTime  = 

Directory .GetCreationTime (@"c : \SYP\Bonk") ; 


File . SetLastWriteTime (@"c: \SYP\copy . txt",  myTime) 


File . Delete (@"c : \SYP\Bonk\weirdo.txt") 
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Use  File  dialogs  to  open  and  save  files 
(all  with  just  a  few  lines  of  code) 


You  can  build  a  program  that  opens  a  text  file.  It'll  let  you  make 
changes  to  the  file,  and  saves  your  changes,  with  very  little  code 
all  using  standard  .NET  controls.  Here’s  how:. 


+  ^ - DotJiis  ^ 


*  Simple  Text  Editor 


Build  a  simple  form. 

All  you  need  is  a  textbox  and  two  buttons.  Drop  the 
OpenFileDialog  and  SaveFileDialog  controls  onto  the  form 
too.  Double-click  on  the  buttons  to  create  their  event  handlers 

and  add  a  private  string  field  called  name  to  the  form. 

Don’t  forget  to  put  a  using  statement  lip  top  for  System. 

10. 

Hook  the  Open  button  up  to  the  OpenFileDialog. 

The  Open  button  shows  an  OpenFileDialog  and  then  uses  File.  ReacLMITcxtQ 
to  read  the  lile  into  the  text  box: 


This  is  a  multiline 
text  bon 


Open  1 1  Save  I 


private  void  open_Click (object  sender,  EventArgs  e)  { 
if  (openFileDialogl .ShowDialog ()  ==  DialogResult .OK)  ( 

name  =  openFileDialogl. FileName;  Clicking  Open  shows  the 

textBoxl . Clear  () ;  OpenFileDialog  control 


textBoxl .Text  =  File . ReadAllText (name) 


) 


Now,  hook  up  the  Save  button. 

The  Save  button  uses  the  File.WriteAHTextO  method  to  save  the  file: 

private  void  save_Click (object  sender,  EventArgs  e)  ( 
if  (saveFileDialogl. ShowDialog ()  ==  DialogResult .OK)  { 
name  =  saveFileDialogl . FileName; 

File.WriteAllText (name,  textBoxl .Text) ; 

) 

) 


The  ReadAHTextO  and 
WriteAHTextO  methods  are  ^ 

?art  of  the  File  tUss.  Thats 

toming  up  on  the  next  page 
We’ll  look  at  them  in  more 
detail  in  just  a  few  fays 


Play  with  the  other  properties  of  the  dialog  boxes. 

4  Use  the  Title  property  of  the  saveFileDialog  to  change  the  text  in 
the  title  bar. 

Set  the  initiulFolder  property  to  have  the  dialog  OjxnFileDialog 
start  in  a  specified  directory. 

4  Filter  the  OpenFileDialog  so  it  will  only  show  text  files  using  the 
Filter  property. 


If  you  don  t  add  a  -filter,  -then 
the  drop-down  lists  at  the  bottom 
of  the  open  and  save  dialog  boxes 
will  be  empty  Try  using  this  filter 
"Text  Files  (*.txt)|*.txt” 
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dispose  in  the  proper  receptacle 


Sharpen  your  pencil 
v  Solution 


.NET  has  two  built-in  classes  with  a  bunch  of  static  methods  for  working 
with  files  and  folders. The  File  class  gives  methods  to  work  with  files, 
and  the  Directory  class  lets  you  work  with  directories.  Your  job  was 
to  write  down  what  each  bit  of  code  did. 


Code 

What  the  code  does 

if  (Directory .Exists (@"c: \SYP") )  { 

Directory .CreateDirectory (@"c: \SYP") ; 

} 

Chedk  if  -the  C;\SVP  -folder  exists  |-f  i-t 
doesn't,  dreate  i-t 

if  (Directory .Exists (@"c : \SYP\Bonk") ) 

Directory. Delete (@ "c:\SYP\Bonk")  ; 

1 

Chedk  if  the  CAS^Bonk  folder  exists.  |f 
it  does,  delete  it- 

Directory .CreateDirectory (@"c: \SYP\Bonk" ) ; 

Create  the  diredtory  C:\£'/P\Bonk 

Directory. SetCreationTime (@"c : \SYP\Bonk", 
new  DateTime (1976,  09,  25)); 

Set  the  dreation  ti»*»e  for  the  C^yTABonk 
folder  to  September  2.5,  1*} 7b. 

string!)  files  =  Directory. GetFiles (@"c: \windows\", 

. log",  SearchOption . AllDirectories) ; 

£jet  a  list  of  all  f  iles  in  C:\Windows  that 
matdh  the  ^  lo^  pattern,  indludm^  all 
matdhin<J  f  iles  in  any  subdiredtory. 

File . WriteAllText (@"c : \SYP\Bonk\weirdo.txt", 

@"This  is  the  first  line 

and  this  is  the  second  line 
and  this  is  the  last  line"); 

Create  a  file  dalled  "weirdo  txt”  fif  it 
doesn't  already  exist)  in  the  C:\Syp\Bonk 
folder  and  write  three  lines  of  text  to  it- 

File. Encrypt (@"c:\SYP\Bonk\weirdo.txt") ; 

^  This  is  a*  alternative  to  usin^ 

_ a  CryptoStream 

Take  advantage  of  built-in  Mndows 
endryption  to  endrypt  the  f  ile  "weirdo  txt” 
usin^  the  lo^^ed  in  addount  s  dredentials. 

File. Copy (@"c: \SYP\Bonk\weirdo.txt", 

@"c: \SYP\copy.txt") ; 

Copy  the  C:'iSy'P\Bonk\weirdo  txt  file  to 
C:\SyP\Copy.txt 

DateTime  myTime  = 

Directory. GetCreationTime (@"c: \SYP\Bonk") ; 

Dedlare  the  myTime  variable  and  set  it  e«\ual 
to  the  dreation  time  of  the  C:\SyV\Bonk 
folder. 

File . SetLastWriteTime (@"c: \SYP\copy. txt",  myTime) ; 

Alter  the  last  write  time  of  the  dopy  txt 
f  ile  in  C;\S^P\  so  it  s  e<\ual  to  whatever 
time  is  stored  in  the  myTime  variable- 

File. Delete (@"c: \SYP\Bonk\weirdo.txt") ; 

Delete  the  CAsyPNBonkNweirdo  txt  file 
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disposable  makes  sure  your  objects  are  disposed  properly 


A  lot  of  .NET  classes  implement  a  particularly  useful  interface  called 
IDisposable.  It  only  has  one  member:  a  method  called  Dispose  () . 

Whenever  a  class  implements  IDisposable,  its  telling  you  that  there 
are  important  things  that  it  needs  to  do  in  order  to  shut  itself  down,  usually 
because  it’s  allocated  resources  that  it  won’t  give  back  until  you  tell  it  to. 
The  Dispose  ( )  method  is  how  you  tell  the  object  to  release  those  resources. 


You  can  use  the  “Go  To  Definition”  feature  in  the  IDE  the  official  C#  £  x  V0**  1 1  learn 
definition  of  IDispoable.  Go  to  your  project  and  type  IDisposable  ">ore  about 

anywhere  inside  the  code.  Then  right-click  on  it  and  select  “Go  To  Definition" 
from  the  menu.  It'll  open  a  new  tab  with  code  in  it.  Expand  all  of  the  code  Definition 
and  this  is  what  you’ll  see:  later  on 


Declare  an 
ol>jed  in  a  using 
block  and  that 
object’s  DisposeO 
method  is  called 
automatically. 


namespace  System 


//  Summary: 


A  lot  of  classes  allocate  important  resources,  like 
memory,  -files,  and  other  objects  That  means 
they  take  them  over,  and  don't  jive  them  back 
until  you  tell  them  it's  done  with  those  resources 


//  Defines  a  method  to  release  allocated  resources 

public  interface  IDisposable 


//  Summary: 

//  Performs  application-defined  tasks 

//  associated  with  freeing,  releasing,  or 

//  resetting  unmanaged  resources. 


void  DisposeO  ; 


Any  class  that  implements  IDisposable  will  immediately 
release  any  resources  that  it  took  over  as  soon  as  you 
call  its  DisposeO  method  It's  almost  always  the  last 
thinj  you  do  before  you’re  done  with  the  object 


To  De-finrtioh 

selecf  T  n  t  «  J  ,  Jusi  '''Sht-Click  on  it  and 

code  that  defines  ii  °"  ’  ^  ^  '"'ll  j<^r  right  ho  the 


al-lo-cate,  verb. 

to  distribute  resources 
or  duties  for  a  particular 
purpose.  The  programming 
team  was  irritated  at  their  project 
manager  because  he  allocated 
oil  oj  the  conference  rooms  for  a 
useless  management  seminar. 


that's  a  lot  of  vet  appointments 


Avoid  file  system  errors  with  using  statements 


We’ve  been  telling  you  all  chapter  that  you  need  to  close  your  streams.  That’s 
because  some  of  the  most  common  bugs  that  programmers  run  across  when  they 
deal  with  files  are  caused  when  streams  aren't  dosed  properly.  Luckily.  C#  gives 
you  a  great  tool  to  make  sure  that  never  happens  to  you:  IDisposable  and 

the  Dispose  ( )  method.  When  you  wrap  your  stream  code  in  a  using 


These  "usiha"  statements  are 
different  from  the  ones  at 
■the  io  of 

statement,  it  automatically  closes  your  streams  lor  you.  All  you  need  to  do  is  ^  ^  7°ur  toc*f 

declare  your  stream  reference  with  a  using  statement,  followed  by  a  block 
of  code  (inside  curly  brackets)  that  uses  that  reference.  When  you  do  that,  the 
using  statement  automatically  calls  the  stream’s  Dispose  ()  method  .is 

soon  as  it  finishes  running  the  block  of  code.  Here’s  how  it  works: 


A  *smOj  statement  15  a'*a7s 
followed  by  a*  objett  dettir*** 


then  a  block  0(  Code 
within  Curly  b races 


using  (StreamWriter  sw  =  new  StreamWriter ("secret  plan.txt")) 


sw. WriteLine ("How  I'll  defeat  Captain  Amaing") ; 
sw . WriteLine ("Another  genius  secret  plan"); 
sw. WriteLine ("by  The  Swindler"); 

}  *S 

W'hen  the  usinij  statement  ends, 
the  Disposed  method  ©f  the  _ _ 

object  bemj  used  is  run.  .  , ,  ,ase,  the  objefct  bemy  wsed  n 

Every  stream  has  a  Dispose()  *  Stream,  so  the  Prosed 

method  that  closes  the  stream.  So  ^od  of  the  Stream  tlass  is  run 

if  you  declare  your  stream  in  a  using  t|oses  the  stream 

statement,  it  will  always  close  itselfl 


These  statements 
use  the  object 
Created  in  the 
“ih3  statement 

above  like  any 
normal  object 


Use  multiple  using  statements  for  multiple  objects 

You  can  pile  using  statements  on  top  of  each  other — you  don’t  need  extra  sets  of  curly 
brackets  or  indents. 

using  (StreamReader  reader  =  new  StreamReader ("secret_plan.txt") ; 
using  (StreamWriter  writer  =  new  StreamReader ("email.txt") ; 

{ 

//  statements  that  use  reader  and  writer 

‘  You  don't  need  to  tall  Closed  on  the 

streams  now,  because  the  us.n^  statement 
will  dose  them  automatitally 
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Any  time  you 
use  a  stream, 
you  skould 

ALWAYS 

declare  it 
inside  a  using 
statement.  Tkat 
makes  sure  it’s 
always  closed! 


reading  and  writing  files 


Trouble  at  work 


Meet  Brian.  Hr  likes  his  job  as  a  developer,  but  lie  loves  taking 
the  occasional  day  off.  But  his  boss  hates  when  people  take 
vacation  days,  so  Brian’s  got  to  come  up  with  a  good  excuse. 


You  can  help  Brian  out  by  building  a  program 
to  manage  his  excuses 


Use  what  you  know  about  reading  and  writing  files  to  build  an 
excuse  manager  that  Brian  can  use  to  keep  track  of  which  excuses 
lie’s  used  recently  and  howr  well  they  went  over  with  the  boss. 


This  asterisk  appears 
when  a  form  has 
unsaved  data 


Brian  wants  to  keep 
all  of  his  Causes  in 
one  plate,  so  lets  let 
him  select  a  folder  to 
store  all  of  the. 


Sometimes  Brian's  too 
laz.y  to  think  up  an 
excuse  Let's  add  a 
button  to  load  up  a 
random  excuse  -from  his 
excuse  folder. 


Contains  one  text 
file  for  each  excuse  iVhen 
Brian  clicks  the  Save  button, 
the  Current  excuse  is  saved  out 
to  the  folder  The  Open  button 
lets  him  open  a  saved  excuse 


you  are  here  ► 
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brian  needs  excuses 


Build  the  excuse  manager  so  Brian  can  manage  his  excuses  at  work. 

ixeftctSe 

)  Build  the  form 

This  form  has  a  few  special  features: 

*  When  the  form’s  first  loaded,  only  the  Folder  button  should  be  enabled  - 

disable  the  other  three  buttons  until  the  user  selects  a  folder. 

*  When  the  form  opens  or  saves  an  excuse,  it  displays  the  file  date  for  the  excuse 
file  using  a  Libel  control  with  AutoSize  set  to  False  and  BorderStyle  set  to 
Fixed  3D. 

*  After  an  excuse  is  saved,  the  form  pops  up  an  “Excuse  Written”  messagebox. 

*  The  Folder  button  brings  up  a  folder  browser  dialog  box.  If  the  user  selects  a 
folder,  it  enables  the  Save,  Open,  and  Random  Excuse  buttons. 

*  The  form  knows  when  there  are  unsaved  changes.  When  there  are  no  unsaved 
changes,  the  text  on  the  form’s  title  bar  is  “Excuse  Manager”.  But  when  the  user 
has  changed  any  of  the  three  fields,  the  form  adds  an  asterisk  (*)  to  the  title  liar. 
The  asterisk  goes  away  when  the  data  is  saved  or  a  new  excuse  is  opened. 

*  The  form  will  need  to  keep  track  of  the  current  folder  and  whether  or  not  the 
current  excuse  has  been  saved.  You  can  figure  out  when  the  excuse  hasn't  been 
saved  by  using  the  Changed  event  handlers  for  the  three  input  controls. 


Excuse 

Description:  string 
Results:  string 
LastUsed:  DateTime 
ExcusePath:  string 

OpenFile(stnng) 

Save(string) 


When  you  drag 
a  fextbox  to  a 
■form  and  double— 

tliek  on  if,  you 

Oeate  a  Changed 
evenf  handler  for 
■that  -field- 


Create  an  Excuse  class  and  store  an  instance  of  it  in  the  form 

Now  add  a  CurrentExcuse  field  to  the  form  to  hold  the  current  excuse.  You’ll  need  three  overloaded 
constructors:  one  for  when  the  form’s  first  loaded,  one  for  opening  up  a  file,  and  one  for  a  random  excuse. 
Add  methods  OpenFile  ( )  to  open  an  excuse  (for  the  constructors  to  use),  and  Save  ( )  to  save  the  excuse. 
Then  add  this  UpdateForm  ( )  mediod  to  update  the  controls  (it'll  give  you  some  hints  about  the  class): 

private  void  UpdateForm  (bool  Changed)  {  ^ — - This  parameter  indicates  whether 

if  (! Changed)  {  ^ _  or  not  the  form  has  chanaed 

,  I,  |  this. description. Text  =  currentExcuse. Description;  you'll  need  a  f  u  Y 

Remember,  t  e  this,  results. Text  =  currentExcuse. Results;  keep  t  .  torm  to 

means  HO T— so  this OastUsed. Value  =  currentExcuse.LastUsed;  '  a  ^his  status, 

this  checks  if  if  (TlVtring. IsNullOrEinpty  (currentExcuse .ExcusePath)  ) 

the  en-Cuse  path  /FiTeDate.Text  =  File. GetLastWriteTime  (currentExcuse. ExcusePath)  .ToStringO  ; 

,s  NOT  null  or  this. Text  =  "Excuse  Manager";  p^fele-cl.ck  on  the  input  Controls  so  the  IDE 

empty-  ’lse  builds  Changed  event  handlers  for  you  The 

this. Text  =  "Excuse  Manager*";  event  handlers  far  the  three  inpu  ^°”lros',J. 

this .  formChanged  =  Changed;  -first  dhany  the  E*tusc  instate  the*  ea 

1  WpdateForm(true)— then  it’s  up  to  you  to  Change 

Othe  fields  on  your  form. 

Make  the  Folder  button  open  a  folder  browser 

When  the  user  clicks  on  the  Folder  button,  the  form  should  pop  up  a  “Browse  for  Folder”  dialog 
box.  The  form  will  need  to  store  the  folder  in  a  field  so  that  die  other  dialog  boxes  can  use  it. 

When  the  form  first  loads,  the  Save,  Open,  and  Random  Excuse  buttons  are  disabled,  but  if 
the  user  selects  a  folder  then  the  Folder  button  enables  them. 
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Make  Save  button  save  the  current  excuse  to  a  file 

Clicking  the  Save  button  should  bring  up  the  Save  As  dialog  box. 

*  Each  excuse  is  sav  ed  to  a  separate  text  file.  The  first  line  of  the  tile  is  the  excuse,  the  second  is 
the  result,  and  the  third  is  the  date  last  used  (use  the  DateTimePicker’s  ToString  ( )  method). 
The  Excuse  class  should  have  a  Save  ( )  method  to  save  an  excuse  out  to  a  specified  file. 

*  When  the  Save  As  dialog  box  is  opened,  its  folder  should  be  set  to  the  folder  that  the  user 
selected  using  the  Folder  button,  and  the  filename  should  be  set  to  the  excuse  plus  a  “.txt” 
extension. 

*  The  dialog  box  should  have  two  filters:  Text  Files  (*.txt)  and  All  Files  (*.*). 

*  If  the  user  tries  to  save  the  current  excuse  but  has  left  either  the  excuse  or  the  result  blank,  the 
form  should  pop  up  a  warning  dialog  box: 

icon  by 

r 


Vo,  d-s?lay  this  fc*tla~aWn  -ton  by 

U*  the  overloaded  Messay&o> cShowO 

method  that  alUs7o,  Wt,tya 

MessayBonlton  parameter. 


Make  the  Open  button  open  a  saved  excuse 

Clicking  the  Save  button  should  bring  up  the  ( )pen  dialog  box. 

*  When  the  Open  dialog  box  is  opened,  its  folder  should  lie  set  to  the  folder  that  the  user 
selected  using  the  Folder  button. 

Add  an  Open  ( )  method  to  the  Excuse  class  to  open  an  excuse  from  a  given  file. 

Use  Convert .  ToDateTime  ( )  to  load  the  saved  date  into  the  DateTimePicker  control. 


Unable  to  save 


* 

* 

* 


If  the  user  tides  to  open  the  current  excuse  but  the  current  excuse  hasn’t  been  saved,  it  pops  up 
this  dialog  box: 


Show  a  Y^s/No  dialog  box  by  using 
the  overloaded  MessageBox.ShowO 
•*e-thod  that  lets  you  specify  the 
MessageBoxButtons-YesNo  parameter. 
If  the  user  clicks  "No",  then  ShowO 
returns  DialogResult  No 


Finally,  make  the  Random  Excuse  button  load  a  random  excuse 

When  the  user  clicks  the  Random  Excuse  button,  it  looks  in  the  excuse  folder,  chooses  one  of  the 
excuses  at  random,  and  opens  it. 

★  Hie  form  will  need  to  save  a  Random  object  in  a  field  and  pass  it  to  one  of  the  overloaded 
constructors  of  the  Excuse  object. 

*  If  the  current  excuse  hasn’t  been  saved,  the  button  should  pop  up  die  same  warning  dialog 
box  as  the  Open  button. 


you  are  here  ► 
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private  bool  CheckChanged ( )  { 
if  (formChanged)  { 

DialogResult  result  =  MessageBox.Show( 

"The  current  excuse  has  not  been  saved.  Continue?", 

"Warning",  MessageBoxButtons.YesNo,  MessageBoxIcon. Warning) ; 
if  (result  ==  QialogResult .No). 

return  false;  ,  , 

)  WlessayBoxShowO  also  returns  a 

return  true;  pialo^Result  enum  that  we  tan  £hetk  ^ere  are 


private  void  description_TextChanged (object  sender,  EventArgs  e) 
currentExcuse. Description  =  description .Text; 

UpdateForm (true) ; 


private  void  results_TextChanged (object  sender,  EventArgs  e) 
currentExcuse .Results  =  results. Text; 

UpdateForm (true) ; 


private  void  las tUsed_ValueChanged (object  sender,  EventArgs  e) 
currentExcuse.LastUsed  =  lastUsed. Value; 


UpdateFormatrue  )7) 


_Passir>5  true  to  UpdateFormO  tells  it 
to  vust  mark  the  -form  as  thanked,  but 
not  update  the  input  Controls 


Here  are  the  three 
Changed  event  handlers 
for  the  three  input 
fields  on  the  form  |f  any 
of  them  are  triggered, 
that  means  the  e*tuse 
Has  thanked,  so  first 
we  update  the  Extuse 
instance  and  then  we 
tall  UpdateFormO,  add 
the  asterisk  to  the 
form’s  title  bar,  and  set 
Changed  to  true- 


public  Class  EXCUSe  (  ™  co^roli 

public  string  Description; 
public  string  Results; 
public  DateTime  LastUsed; 
public  string  ExcusePath;  The  Random  Extuse  tv  , 

public  Excuse  ()  {  read  all  of  the  text  f  I  •  "m*  ,  ^ctFilesO  to 

public  Excuse (string  excusePath)  (  r 

OpenFile (excusePath) ;  J 

>  s/ 

public  Excuse (Random  random,  string  folder)  (  H/^ 

string!]  fileNames  =  Directory. GetFiles (folder,  "*.txt");^ 

OpenFile (fileNames [random. Next (fileNames . Length) ] ) ;  f 

1  J 

private  void  OpenFile  (string  excusePath)  {  . 

this .ExcusePath  =  excusePath; 

using  (StreamReader  reader  =  new  StreamReader (excusePath) ) 

Description  =  reader .ReadLine () ; 

Results  =  reader .ReadLine () ; 

LastUsed  =  Convert .ToDateTime (reader .ReadLine ()) ; 

) 

) 

public  void  Save  (string  fileName)  (  j 

using  (StreamWriter  writer  =  new  StreamWriter  (fileName)  )V. 

<  .  .  .  .  > 

writer .WriteLine (Description) ;  \ 

writer .WriteLine (Results) ; 

writer. WriteLine(LastUsed.ToString() ) ;  _ , 

)  )  > 


a>nri)  '»dex  to  open. 

We  made  sure  to  use  a  usin$ 
statement  every  time  we 
opened  a  stream  That  way 
(  our  files  will  always  be  tlosed 


Here’s  where  the  usin$ 
statement  tomes  m  We 
detlared  the  StreamWriter 
inside  of  a  us.n5  statement, 

so  its  CloseO  -etkod** 

tailed  for  us  automatitally. 


i'm  the  decider 


Writing  files  usually  involves  making 
a  lot  of  decisions 

You'll  write  lots  of  programs  that  Like  a  single  input,  maybe  front  a 
lile,  and  have  to  deride  what  to  do  based  on  that  input.  Here’s  rode 
that  uses  one  long  if  statement — it’s  pretty  typical.  It  checks  the 
part  variable  and  prints  different  lines  to  the  file  based  on  which 
enum  it  uses.  There  are  lots  of  choices,  so  lots  of  else  ifs: 


enum  BodyPart 
Head, 

Shoulders, 

Knees, 

Toes 


} 


Here  s  an  enum— we  II  want  to  Compare 
a  variable  against  each  of  tbe  four 
members  and  write  a  different  line  to  the 
StreamlfVriter  depending  on  which  one  it 
matches-  We  II  also  write  something  di-f-ferent 
if  none  of  them  match 


private  void  WritePartlnf o (BodyPart  part,  StreamWriter  writer) 
if  (part  ==  BodyPart .Head) 

writer .WriteLine ("the  head  is  hairy"); 
else  if  (part  ==  BodyPart .Shoulders) 

writer .WriteLine ("the  shoulders  are  broad" 
else  if  (part  ==  BodyPart . Knees)  ^ - 


writer .WriteLine ("the  knees  are  knobby"); 
else  if  (part  ==  BodyPart .Toes) 

writer .WriteLine ("the  toes  are  teeny");  , 
else  rf- _ 


|f  we  use  a  series  of  if/ «>« 
statements,  then  we  end 
up  writing  this  “if  <jart 
-=ToptiorJ)"  over  and  over- 


writer .WriteLine ("some  unknown  part  is  unknown"); 


„  rtf ;  **  » «« 

*e  didn  t  find  a  match. 


r-  - 

What  sort  of  things  can  go  wrong  when  you  write  code 
that  has  this  many  if/else  statements?  Think  about  typos 
and  bugs  caused  by  brackets,  a  single  equals  sign,  etc. 
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Use  a  switch  statement  to 
choose  the  right  option 

Comparing  one  variable  against  a  bunch  of  different  values  is 
a  really  common  pattern  that  you'll  see  over  and  over  again. 
It’s  especially  common  when  you're  reading  and  writing 
files.  It's  so  common,  in  fact,  that  C#  has  a  special  kind  of 
statement  designed  specifically  for  this  situation. 

A  switch  statement  lets  you  compare  one  variable  against 
many  values  in  a  way  that's  easy  to  read  and  is  compact. 
Here's  a  switch  statement  that  does  exactly'  the  same  thing  as 
the  series  of  if /else  statements  on  the  opposite  page: 

enum  Body Part 

{ 


There’s  nothing  about  a  switch 
statement  that’s  specifically 
related  to  -files.  It’s  just  a  useful 
C#  tool  that  we  can  use  here- 

A  switch  statement 
compares  ONE 
variable  against 

MULTIPLE 

possible  values. 


Head, 

Shoulders, 

Knees, 

Toes, 


You’ll  start  with  the  switch 
keyword  followed  by  the  variable 
that’s  going  to  be  compared  against 
a  bunch  of  different  possible  values. 


private  vo. ra  WritePartlnfo (BodyPart  part,  StreamWriter  writer) 

{ 


Every 
case  must 
end  with 
"break;" 


switch  (part)'  { 

case  BodyPart . Head: 

writer .WriteLine ("the  head  is  hairy"); 
break; 

case  BodyPart • Shoulders : 

writer .WriteLine ("the  shoulders  are  broad") 
^  break; 


case  BodyPart . Knees : 

writer .WriteLine ("the  knees  are  knobby"); 
break; 

case  BodyPart. Toes: 

writer .WriteLine ("the  toes  are  teeny"); 
break; 

(  default: 


The  body  of  the  switch 
statement  is  a  series 
of  Cases  that  Compare 
whatever  follows  the 
switch  keyword  against 
a  particular  value. 


Each  of  these  cases  Consists 
of  the  case  keyword 
followed  by  the  value 
to  Compare  and  a  Colon 
After  that  is  a  series  of 


bU  LUOL  '  -  u  iv-  n 

writer  .WriteLine  ("some  unknown  part  is  unknown");  statements  followed  by 


,  C  break; 

\  Switch  statements  can  end 

\  with  a  default  block  that  gets 

V - executed  if  none  of  the  other 

Mses  are  matched 


"break;”.  Those  statements 
will  be  executed  if  the  case 
matches  the  Comparison  value 
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Use  a  switch  statement  to  let  your  deck  of  cards 
read  from  a  file  or  write  itself  out  to  one 

Writing  a  card  out  to  a  file  is  straightforward  just  make  a  loop  that  writes  the  name 
of"  each  card  out  to  a  file.  Here’s  a  method  you  can  add  to  the  Deck  object  that  does 
exactly  that: 

public  void  WriteCards (string  Filename)  { 

using  (StreamWriter  writer  =  new  StreamWriter (Filename) )  ( 
for  (int  i  =  0;  i  <  Cards. Count;  i++)  { 
writer . WriteLine (Cards [ i ] . Name ) ; 

) 


) 


} 


But  what  about  reading  the  file  in?  It’s  not  quite  so  simple.  That’s  where  the  switch 
statement  can  come  in  handy. 


Card. Suits  suit; 
switch  (suitstring)  ( 
case  "Spades": 

suit  =  Card. Suits . Spades ; 
break ; 

case  "Clubs" 


The  switch  silent  skrk  with  a 
value  to  ^ Pare  against.  This  switch 
^ate«e»t  is  called  from  a  method 
that  has  a  suit  stored  in  a  string. 


The  switch 
statement  lets 
you  test  one 
value  against  a 
hunch  ol  cases 
and  execute 
different 
statements 
depending  on 
which  one  it 
matches. 


suit  =  Card . Suits . Clubs ; 
break ; 

case  "Hearts": 

suit  =  Card . Suits . Hearts ; 
break ; 

case  "Diamonds": 

suit  =  Card. Suits . Diamonds ; 
break ; 

default : 

MessageBox . Show (suitstring  + 


Each  of  t he*  ta sc  lines  compares 
some  value  against  the  value  m 
the  switch  line-  if  they  match, 
rt  executes  all  of  the  following 
statements  until  it  hits  a  break 


The  default  line  Comes  at  the  end 
If  none  of  the  Cases  match,  the 
statements  after  the  default  get 
executed  instead- 

isn't  a  valid  suit!") 
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Add  aw  overloaded  Peck!)  constructor  that 
reads  a  deck  of  cards  iw  from  a  file 

You  ran  use  a  switch  statement  to  build  a  new  constructor  for  the  Deck 
class  that  you  wrote  in  the  last  chapter.  This  constructor  reads  in  a  file  and 
checks  each  line  for  a  card.  Any  valid  card  gets  added  to  the  deck. 

There’s  a  method  that  you  can  lincl  on  every  string  that'll  come  in  handy: 

Split  () .  It  lets  you  split  the  string  into  an  array  of  substrings  by  passing  it 

a  char  [  ]  array  of  separator  characters  that  it'll  use  to  split  the  string  up.  ^his  line  -tells  C#  to  split  the  nextCard 

string  using  a  space  as  a  separator 

public  Deck  (string  Filename)  {  character.  That  splits  the  string  "Six 

Cards  =  new  List<Card> () ;  °f  Diamonds"  into  the  array 

StreamReader  reader  =  new  StreamReader  (Filename) ;  ("Six",  "of",  "Diamonds"), 

while  (! reader .EndOf Stream)  { 
bool  invalidCard  =  false; 
string  nextCard  =  reader .ReadLine () ; 

string []  cardParts  =  nextCard. Split (new  chart]  I  '  '  )); 

Card. Values  value  =  Card. Values .Ace; 
switch  (cardParts [0] )  { 

case  "Ace":  value  =  Card. Values. Ace;  break; 
case  "Two":  value  =  Card. Values. Two;  break; 
case  "Three":  value  =  Card. Values. Three;  break; 
case  "Four":  value  =  Card. Values. Four;  break; 
case  "Five":  value  =  Card. Values. Five;  break; 
case  "Six":  value  =  Card. Values. Six;  break; 
case  "Seven":  value  =  Card. Values. Seven;  break; 
case  "Eight":  value  =  Card. Values. Eight;  break; 
case  "Nine":  value  =  Card. Values. Nine;  break; 
case  "Ten":  value  =  Card. Values. Ten;  break; 
case  "Jack":  value  =  Card. Values. Jack;  break; 
case  "Queen":  value  =  Card. Values. Queen;  break; 
case  "King":  value  =  Card. Values. King;  break; 
default:  invalidCard  =  true;  break; 

} 


This  switch  statement 
checks  the  -first  word 
,h  l'»e  to  see  i-f  it 
matches  a  value.  |-f  it 
d<*s,  the  right  value 
is  ^signed  to  the 
value  variable- 


Card. Suits  suit  =  Card. Suits. Clubs; 
switch  (cardParts [2] )  { 

case  "Spades":  suit  =  Card. Suits. Spades;  break; 
case  "Clubs":  suit  =  Card. Suits. Clubs;  break; 
case  "Hearts":  suit  =  Card. Suits. Hearts;  break; 
case  "Diamonds":  suit  =  Card. Suits. Diamonds;  break; 
default:  invalidCard  =  true;  break; 

} 

if  (! invalidCard)  { 

Cards .Add (new  Card  (suit,  value)); 


VVe  do  the  same  thing  for 
the  third  word  in  the  line, 
e*Cept  we  Convert  this 
one  to  a  surt- 
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p.s.  i’ll  find  my  frog 


All  that  code  just  to  read  in  one  simple  card? 

That's  way  too  much  work!  What  if  my  object  has  a 
whole  bunch  of  fields  and  values?  Are  you  telling  me  I 
need  to  write  a  switch  statement  for  each  of  them? 


There’s  an  easier  way  to  store  your  objects  in 
files.  It’s  called  serialization. 

Instead  of  painstakingly  writing  out  each  field  and  value  to 
a  file  line  by  line,  you  can  save  your  object  the  easy  way  by 
serializing  it  out  to  a  stream.  Serializing  an  object  is  like 
flattening  it  out  so  you  can  slip  it  into  a  file.  And  on  the 
other  end,  you  can  deserialize  it,  which  is  like  taking  it  out 
of  the  file  and  inflating  it  again. 
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What  happens  to  an  object  when  it's  serialized? 

It  seems  like  something  mysterious  has  to  happen  to  an  object  in  order  to  copy 
it  ofT  of  the  heap  and  put  it  into  a  file,  but  it’s  actually  pretty  straightforward. 


Q  Object  on  the  heap 


^  Object  serialized 


When  you  create  an  instance  of  an 
object,  it  has  a  state.  Everything 
that  an  object  “knows”  is  what  makes 
one  instance  of  a  class  different  from 
another  instance  of  the  same  class. 


When  G#  serializes  an  object,  it  saves 
the  complete  state  of  the  object,  so 

that  an  identical  instance  (object)  can  be 
brought  back  to  life  on  the  heap  later. 


\Width  Height 


are 

the  stvea- 


-*> 


OOlOOlOl  £ 

oiooono 


file.dat 


*?' 'ed  the  fi|e 

a  little  .ore 

f°  ^  CLR  tweeds 

,kf  tKc  %  ^  the  object 
a"d  each  of  its  fields.) J 


Object  on  the  heap  again 


^  And  later  on... 

loiter  maybe  days  later,  and  in  a 
different  program  you  can  go  back  to 
Ihe  file  and  deserialize  it.  That  pulls 
the  original  class  back  out  of  the  file 
and  restores  it  exactly  as  it  was.  with 
all  of  its  fields  and  values  intact. 
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save  the  cheerleader 


Put  what  exactly  IS  an  object's  state? 

What  Meeds  to  be  saved? 

We  already  know  that  an  object  stores  its  state  in  its  fields.  So  when  an 
object  is  serialized,  every  one  of  those  those  fields  needs  to  be  saved  to  the  file. 

Serialization  starts  to  get  interesting  when  you  have  more  complicated  objects.  37 
and  70  are  bytes — those  are  value  types,  so  they  can  just  lx-  written  out  to  a  file 
as-is.  But  what  if  an  object  has  ;m  instance  variable  dial’s  an  object  reference ?  What 
about  an  object  that  has  five  instance  variables  that  are  object  references?  What  if 
those  object  instance  variables  themselves  have  instance  variables? 

Think  about  it  for  a  minute.  What  part  of  an  object  Is  potentially  unique?  Imagine 
what  needs  to  be  restored  in  order  to  get  an  object  that’s  identical  to  the  one  that 
was  saved.  Somehow  everything  on  the  heap  has  to  be  written  to  the  file. 


_ 

What  has  to  happen  for  this  Car  object  to  be  saved  so 
that  it  gets  restored  back  to  its  original  state?  Let's  say 
the  car  has  three  passengers  and  a  3-liter  engine  and 
all-weather  radial  tires...  aren't  those  things  are  part  of  the 
state?  What  should  happen  to  them? 


Wett  h*  ^l'rtr'LCS 
TVe  .  ar  *r*i 

of  TW*  a 

_  fo  the** 
bay?*'*  ^  1 


art 


t-Qr 


The  Engine  object  is 
private  Should  rfc  be 


Qssar\op 


Each  of  the  yassengev 
objects  has  its  own 
efeventes  to  other 
objects  Po  those  need 
to  be  saved,  too? 
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When  an  object  is  serialized,  all  of  the  objects 
it  refers  to  get  serialized  too... 


...and  all  of  the  objects  they  refer  to,  and  all  of  the  objects  those  other  objeets  refer  to, 
and  so  on  and  so  on.  But  don’t  worry — it  may  sound  complicated,  but  it  all  happens 
automatically.  C#  starts  with  the  object  you  want  to  serialize  and  looks  through  its 
lields  for  other  objects.  Then  it  does  the  same  for  each  of  them.  Every  single  object 
gets  written  out  to  the  file,  along  with  all  the  information  C#  needs  to  reconstitute  it 


Breed. Beagle 
4  years  old 
32  pounds 
14"  tall 


One  of  -the  fields  of 
■the  fennel  object  is 
this  Ust<Doy  that 
Contains  two  Pog 
objeets,  SO  C#  will 
need  to  serialise 
the  too 


Breed. Mutt 
6  years  old 
18  pounds 
11“  tall 


Eaeh  of  the  two  Pog  objects 
has  references  to  a  PoggyIP 
object  and  a  Collar  object- 
They'll  need  to  get  serialized 
along  with  each  Pog 


PoggyIP  a:; 

oTthe  line— they  dont 
.Terences  to  any  othe» 
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serialized  for  your  protection 


Serialization  lets  you  read  or  write 
a  whole  object  all  at  once 

You’re  not  just  limited  to  reading  and  writing  lutes  of  text  to  your  files.  You  can 
use  serialization  to  let  your  programs  copy  entire  objects  to  files  and  read 
them  back  in...  all  in  just  a  few  lines  of  code!  There’s  a  liny  amount  of  prep  work 
you  need  to  do  add  one  [Serializable]  line  to  the  top  of  the  class  to 
serialize — but  once  you  do  that,  everything’s  ready  to  write. 

You'll  need  a  &inaryFormatter  object 

If  you  want  to  serialize  an  object — any  object — the  first  thing  you  do  is  create  an 
instance  of  BinaryFormatter.  It’s  really  straightforward  to  do — and  all  it  takes 
is  one  line  of  code  (and  an  extra  using  line  at  the  top  of  the  class  file). 


It’s  (juick  to  copy 
an  object  out  to 
a  file  or  read  it 
in  from  one.  You 
can  serialize  or 
deserialize  it. 


using  System. Runtime . Serialization . Formatters . Binary; 


BinaryFormatter  formatter  =  new  BinaryFormatter () ; 


Now  just  create  a  stream  and  read  or  write  your  objects 

Use  the  Serialize  ()  method  from  the  BinaryFormatter  object  to  write  any 
object  out  to  a  stream. 


The  Fil eCreateO  method 

creates  a  new  -file,  you  can 

existing  one  using  File. 
0penMriteO. 


Stream  output  =  File . Create (filenamestring) ; 


formatter . Serialize (output ,  ob jectToSerialize) ; 

output .  Close  ( )  ;  ^  The  SerializeO  method  takes  an 

|f  you  use  a  using  statement,  V  object  and  writes  it  out  to  a 

- - CloseO  will  be  called  automatically  stream  That’s  a  whole  lot  easier 

And  once  you  \c  j^ot  sn  ohject  sn inlizrd  out  to  file,  use  t lie*  Bin<uryForni£ittef  3  ^  ethod  to  write  it 

object’s  Deserialize  ( )  method  to  read  it  back  in.  The  method  returns  a  , 

reference,  so  you  need  to  cast  the  output  so  that  it  matches  the  type  of  the  reference  ' 
variable  you’re  copying  it  to. 

Stream  input  =  File , OpenRead (filenamestring) ; 

SomeObj  obj  =  (SomeObj ) formatter . Deserialize (input) ; 


input . Close ( ) ; 


VVhen  you  use  Deseriali«0  -to  read  an 
object  back  -from  a  stream,  don't  forget 
to  cast  the  return  value  b>  match  the 
tyye  of  object  you're  reading. 
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If  you  want  your  class  to  be  serializable,  mark  it 
with  the  [Serializable]  attribute 


An  attribute  is  a  special  tag  that  you  can  add  to  the  top  of  any  C#  class.  It's  how  C#  stores 
metadata  about  your  code,  or  information  about  how  the  code  should  be  used  or  treated.  When  you 
add  [Serializable]  to  the  top  of  a  class  just  above  the  class  declaration,  you’re  telling 
C#  that  your  class  is  safe  for  serialization.  And  you  only  use  it  with  classes  that  include  fields  that  are 
either  value  types  (like  an  int,  string,  or  enum)  or  other  serializable  classes.  If  you  don’t  add  the 
attribute  to  the  class  you  want  to  serialize,  or  if  you  include  a  field  with  a  type  that  isn’t  serializable, 
then  your  program  will  have  an  error  when  you  try  to  run  it.  See  for  yourself... 

%  S — Do  this 


Create  a  class  and  serialize  it 


Remember  the  Guy  Class  from  Chapter  3?  Let’s  serialize  Joe  so  we  can  keep  a  file  that  knows  how  much 
money  lie’s  got  in  his  pockets  even  after  you  close  your  program. 


[Serializable] 
public  class  Guy 


Here’s  code  to  serialize  it  to  a  file  called  “Guy_file.dat” — add  a  “Save  Joe”  button  and  a  “Load  Joe” 
button  to  the  Form 


using  System. 10; 

using  System. Runtime . Serialization. Formatters. Binary; 


private  void  saveJoe_Click (object  sender,  EventArgs  e) 
1 

using  (Stream  output  =  File. Create ("Guy_File.dat") ) 
BinaryFormatter  formatter  =  new  BinaryFormatter () ; 
formatter. Serialize (output,  Joe) ; 

} 

) 

private  void  loadJoe_Click (object  sender,  EventArgs  e) 
{ 


< 


You  II  need  these  two 
using  lines.  The  -first 
one  is  -for  the  -file  and 
stream  methods,  and  the 
second  is  -for  serialization. 


WhaTt  m  the*  pockett? 

Joe  has  SO  bucks 
Bob  Nm  100  bucks 


Amourt  |0 


using  (Stream  input  =  File. OpenRead ("Guy_File.dat") ) 
BinaryFormatter  bf  =  new  BinaryFormatter () ; 

Joe  =  (Guy) bf . Deserialize (input) ; 

)  ; 

CheckGuys  ( ) ; 


Joe  grvei  to  Bob 


Joe  Taken  item  Bob 


Bob9v*sioJoe 


Bob  takes  Item  Joe 


|  Save  Joe  ~|  [  LoedJoe 


Run  the  program  and  play  around  with  it. 

If  Joe  had  two  hundred  dollars  saved  up  from  his  transactions  with  Boh  during  your  time  running 
the  program,  it  would  be  a  pain  to  lose  all  that  money  just  because  you  needed  to  exit.  Now  your 
program  can  save  Joe  out  to  a  file  and  restore  him  whenever  you  want. 
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/  like  milk  on  my  serial 


Let's  serialize  and  deserialize  a  deck  of  cards 

l  ake  a  clerk  of  rai  ds  and  write  it  out  to  a  file.  C#  makes 
serializing  objects  really  easy.  All  you  need  to  do  is 
create  a  stream  and  write  out  your  objects. 

Create  a  new  project  and  add  the  Deck  and  Card  classes 

Right-click  on  the  project  in  the  Solution  Explorer  and  choose  “Add/Existing  Item”,  and  add  the 
Card  and  Deck  classes  you  created  in  Chapter  7.  You’ll  also  need  to  add  the  two  card  comparer 
classes,  since  Deck  uses  them.  The  IDE  will  copy  the  files  into  the  new'  project — make  sure  you 
change  the  namespace  line  at  the  top  of  each  class  file  to  match  your  new  project’s  namespace. 


O 

O 


Mark  all  of  the  classes  serializable  ,  r  , 

Add  the  [Serializable]  attribute  to  all  of  the  classes  you  added  to  Y0**  ow  t  d° 

the  project.  ,this,  C^r  won't  let 

- ^  you  serialise  the 

classes  to  a  -file- 


Add  a  couple  of  useful  methods  to  the  form 

The  RandomDeck  method  creates  a  random  deck  of  cards,  and  the 
PrintCards  method  deals  all  of  the  cards  and  prints  them  to  llie  console. 


Random  random  =  new  Random ( ) ; 
private  Deck  RandomDeck (int  Number)  { 
Deck  myDeck  =  new  Deck (new  Card!]  < 
for  (int  i  =  0;  i  <  Number;  i++) 


( 

my Deck. Add (new  Card( 

(Card. Suits) random. Next (4) , 
(Card. Values) random. Next (1, 


))  ; 


This  create!-  an 
deck  and  then  adds  so~e 
random  tards  to  >t  us.n$ 
the  Card  tlass  £rom  the 
last  thafter 


14))); 


) 


return  myDeck; 

) 


private  void  DealCards (Deck  DeckToDeal,  string  Title) 
Console. WriteLine (Title)  ; 
while  (DeckToDeal .Count  >  0) 

( 

Card  nextCard  =  DeckToDeal . Deal () ; 

Console. WriteLine (nextCard. Name) ; 

) 

Console. WriteLine  (" - *) ; 


"Hie  DealCardsO 
method  deals  each  of 
the  cards  off  of  the 
deck  and  prints  it  to 
the  do^s ole 


) 
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Okay,  prep  work's  done.,  now  serialize  that  deck 

Start  by  adding  buttons  to  serialize  a  random  deck  to  a  file  and  read  it  back.  Check  the 
console  output  to  make  sure  the  deck  you  wrote  out  is  the  same  as  the  deck  you  read.  ,  ■_ 

The  BinaryFormatter  otytt 

private  void  buttonl_Click  (object  sender,  EventArgs  e)  {  ^kes  any  object  marked  with 
Deck  deckToWrite  =  RandomDeck  (5) ;  ,  Cgrializable  attribute—1*' 

using  (Stream  output  =  File. Create ("Deckl .dat") )  obietb— and 

BinaryFormatter  bf  =  new  BinaryFormatter  £^sc  3  e  using 

bf .Serialize (output,  deckToWrite);  writes  it  out  a 

)  its  Seriali^O  method 


DealCards (deckToWrite,  "What  I  just  wrote  to  the  file"); 


private  void  button2_Click (object  sender,  EventArgs  e)  { 
using  (Stream  input  =  File. OpenRead ("Deckl .dat") )  ( 
BinaryFormatter  bf  =  new  BinaryFormatter () ; 

Deck  deckFromFile  =  (Deck) bf . Deserialize (input) ; 

DealCards (deckFromFile,  "What  I  read  from  the  file"); 


The  BrnaryTormatter's 
DesenalizeO  method  returns 
an  Object,  which  is  just  the 
Seneral  type  that  every  C# 
object  inherits  from-which  is 
why  we  need  to  cast  it  to  a 
Deck  object 


Now  serialize  a  bunch  of  decks  to  the  same  file 

Once  you  open  a  stream,  you  can  write  as  much  as  you  want  to  it.  You  can  serialize  as 
many  objects  as  you  need  into  the  same  file.  So  now  add  two  more  buttons  to  write  out  a 
random  number  of  decks  to  the  file.  Check  the  output  to  make  sure  everything  looks  good. 


private  void  button3_Click (object  sender,  EventArgs  e)  { 
using  (Stream  output  =  File. Create ("Deckl .dat") )  ( 
BinaryFormatter  bf  =  new  BinaryFormatter () ; 
for  (int  i  =  1;  i  <=  5;  i++)  { 


ybu  Can  serialise  {  Deck  deckToWrite  =  RandomDeck  (random. Next  (1, 10)  )  ;  the  output  ot  Deserializ^O 
e  obsett  after  )  bf  .Serialize  (output,  deckToWrite) ;  to  a  Deck.  That's  because 

another  to  the  DealCards  (deckToWrite,  "Deck  #"  +  i  +  ”  written") ; Deser,aliz*0  returns  an 

same  stream  object,  but  doesn't  necessarily 

j  know  what  type  of  object 

private  void  button4_Click (object  sender,  EventArgs  e)  {  ^ 

using  (Stream  input  =  File. OpenRead  ("Deckl . dat") )  {  long  as  you  Cast  the 
BinaryFormatter  bf  =  new  BinaryFormatter  () ;  ^  ^  u 

for  (int  i  =  1;  i  <=  5;  i++)  (  c —  /  ,  .  ,  , 

Deck  deckToRead  =  (Deck) bf .  Deserialize  (input)  ;  C  *  C 
DealCards  (deckToRead,  "Deck  #"  +  i  +  "  read") ;  s  1,0  l,mrk  ^he 

)  number  of  objects  you  can 

)  serialize 


Notice  how  the  line  that 
reads  a  Single  deck  from 
the  file  uses  (Deck)  to  cast 
the  output  of  DeserializeO 
b>  a  Deck  That's  because 


Take  a  look  at  the  file  you  wrote 

Open  up  Deek  I  .dat  in  Notepad.  It  may  not  be  quite  something  you’d  read  on  the 
beach,  but  it's  got  all  the  information  to  restore  your  whole  deck  of  cards. 
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builds  character 


Woit  a  minute.  I'm  not  sure  I  like  all  this  writing  objects  out 
to  some  weird  file  that  looks  like  garbage  when  I  open  it  up.  When 
I  wrote  the  deck  of  cards  as  strings,  I  could  open  up  the  output  in 
Notepad  and  see  everything  in  it.  Isn't  C#  supposed  to  make  it  easy 
for  me  to  understand  everything  I'm  doing? 


When  you  serialize  objects  out  to  a  file,  they’re 
written  in  a  binary  format. 

But  that  doesn’t  mean  it’s  indecipherable  just  compact.  That’s  why  you 
can  recognize  the  strings  when  you  open  up  a  file  with  serialized  objects 
in  it:  that’s  the  most  compart  way  C#  can  write  strings  to  a  file  as 
strings.  But  writing  out  a  number  as  a  string  would  be  really  wasteful. 
Any  int  can  lie  stored  in  four  bytes.  So  it  would  be  odd  if  C#  stored, 
say,  the  number  49,369, 1 44  as  an  8-character  string  that  you  could 
read  10  characters  if  you  include  commas.  That  would  be  a  waste  of 


space! 


NET  uses  Unicode  to  encode  a  char  or  string  into  bytes.  Luckily,  Windows  has  a  useful 
little  tool  to  help  us  figure  out  how  Unicode  works.  Open  up  the  Character  Map  (it's  in  the 
Start  menu  under  Accessories,  or  do  Start  /  Run  and  type  "charmap.exe'j. 


When  you  look  at  all  the  letters  and  symbols  that  are  used  in  languages  all  around  the  world,  you  realize  just  how 
many  different  things  need  to  be  written  to  a  file  just  to  store  text.  That’s  why  .NET  encodes  all  of  its  strings  and 
characters  in  a  format  called  Unicode.  Encoding  just  means  taking  the  logical  data  (like  the  letter  H)  and  turning  it 
into  bytes  (the  number  72).  It  needs  to  do  that  because  letters,  numbers,  enums  and  other  data  all  end  up  in  b\tes 
on  disk  or  in  memory.  And  that’s  why  Character  Map’s  useful-  it  shows  you  how  letters  are  encoded  into  numbers. 


Select  'the  Atrial  font  and 
stroll  down  until  you  reach 
■the  Hebrew  letters  Find  the 
letter  Skin  and  tlitk  on  it- 


As  soon  as  you  click  on  the 
letter,  its  Unicode  number 
shows  up  in  the  status  bar  Tke 
Hebrew  letter  Shin  is  number 
OG&).  That's  a  hexadecimal 
number— "hex"  -for  shor-t 

i 

You  can  Convert  it  to  decimal  usin5 
the  Windows  calculator:  open  it  up, 
put  it  in  Scientific  mode,  click  the 
Hex  radio  button,  enter  " 0 
and  then  Click  "Dec"— it’s  1,5/ T 


'  Character  Map 
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Characters  to  copy  Q  |  Y  Vi) 


Select  ~|  Copy 


'Advanced  view 


U*05E9^’ebrew  Letter  Shin 


Unicode  is  an  industry  standard  developed  by  a  non-prof  it  youp  called  the 
Unicode  Consortium,  and  it  works  across  programs  and  different  Computer 
platforms  Take  a  minute  and  look  at  their  website:  http:/ / www.un.eode  ory 
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.NET  converts  text  to  Unicode  automatically 

The  two  C#  value  types  for  storing  text  —  string  and  char — keep  their  data  in 
memory  as  Unicode.  When  that  data’s  written  out  as  bytes  to  a  file,  eacli  of  those 
Unicode  numbers  is  written  out  to  the  file.  So  start  a  new  project  and  drag  three 
buttons  onto  a  form,  and  we'll  use  the  File.WritcAllBytesO  and  ReadAllBytes()  methods 
to  get  a  sense  of  exactly  how  Unicode  data  is  written  out  to  a  file. 


Do  thh! 


Write  a  normal  string  out  to  a  file  and  read  it  back 

Use  the  same  WritcAllTextO  method  that  you  used  in  the  text  editor  to  have  the  first  button 
write  the  string  “Eureka!”  out  to  a  file  called  “eureka.txt”.  Then  create  a  new  byte  array  called 
eurekaBytes,  read  the  file  into  it.  and  then  print  out  all  of  the  byles  read: 


File. WriteAllText ("eureka.txt",  "Eureka!") ; 

byte[]  eurekaBytes  =  File. ReadAllBytes ("eureka.txt") ; 

foreach  (byte  b  in  eurekaBytes)  ^  The  ReadAllBytesO  method  returns  a  reference 

Console. Write (” (0)  ",  b) ;  ^  to  a  new  array  of  bytes  that  Contains  all  of  the 

Console. Wr iteLine () ;  bytes  that  were  read  m  com  the  i  e 

You’ll  see  these  bytes  written  to  the  output:  69  117  114  101  107  97  33.  Now  open  up  the 
file  in  the  Simple  Text  Editor  that  you  wrote  earlier  in  the  chapter.  It  says  “Eureka!” 


Make  the  second  button  display  the  bytes  as  hex  numbers 

It's  not  just  Character  Map  that  shows  numbers  in  hex.  Almost  anything  yrou  read  that  has  to  do 
with  encoding  data  will  show  that  data  in  hex,  so  it's  useful  to  know  how  to  work  with  it.  Make 
the  code  for  second  button’s  ev  ent  handler  in  your  program  identical  to  the  first  one,  except 
change  the  Console. Write()  line  so  it  looks  like  this  instead:  Hex  uses  the  numbers  0  through  an d 

Console. Write(”(0:x2)  ",  b) ;  letters  A  through  F  to  represent  numbers 

in  base  I®,  so  is  e«p»al  to  107. 

That  tells  WriteQ  to  print  parameter  #0  (the  first  one  after  the  siring  to  print)  as  a  two-charaol 
hex  code.  So  it  writes  the  same  seven  bvtes  in  hex  instead  of  decimal:  4 5  75  72  65  6b  61  21 


nt  numbers 

7  \ 

L'ter  J 

21 


Make  the  third  button  write  out  Hebrew  letters 

Co  back  to  Character  Map  and  double-click  on  the  Shin  character  (or  click  the  Select  button).  It’ll  add 
it  to  the  “Characters  to  copy”  box.  Then  do  the  same  for  the  rest  of  the  letters  in  “Shalom”:  Lamed 
(U+05DC),  Vav  (U+05D5),  and  Final  Mem  (U+05DD).  Now  add  the  code  for  the  third  button’s  event 
handler.  It'll  look  exactly  like  button  2,  except  for  one  change.  Click  the  “Copy”  billion  in  Character 
Map.  and  then  paste  the  letters  over  “Eureka!”  so  it  looks  like  this: 


File.  WriteAllText  ("eureka .  txt",  "D1  *70)") ; 


Did  you  notice  Unit  the  IDE  pasted  the  letters  in  backwards.’  That’s  because  it  knows  dial  Hebrew  is 
read  right-to-left,  so  any  time  it  encounters  Hebrew  Unicode  letters,  it  displays  them  right-to-left.  Put 
your  cursor  in  the  middle  of  the  letters — the  left  and  right  arrow  key  s  reversed!  That  makes  it  a  lot  easier 
if  you  need  to  type  in  Hebrew.  Now  run  the  code,  and  look  closely  at  the  output:  f  f  fe  e9  05  dc  05 
d5  05  dd  05.  The  first  two  characters  are  “FF  FE”,  which  is  die  Unicode  way  of  saying  that  we’re 
going  to  have  a  string  of  two-byte  characters.  The  rest  of  die  bytes  are  die  Hebrew  letters  hut  they’re 
reversed,  so  U+05E9  appears  as  e9  05.  Now  open  the  file  up  in  your  Simple  Text  Editor  it  looks  right! 
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take  a  byte  out  of  crime 


C#  caw  use  byte  arrays  to  wove  data  arouwd 


Since  all  your  data  ends  up  encoded  as  bytes,  then  it  makes 
sense  to  think  of  a  file  as  one  big  byte  array.  And  you  already 
know  how  to  read  and  write  byte  arrays. 


This  is  a  static  method 
Arrays  that 

order  the  bytes  ^e  re 

iust  usir*  it  to  she*  that  the 

'ihanys^^Jetothebyte 

array  yt  written  out  to  the 
file  exactly  ^ _ 


Men  the  yroyam  ^rtes 
byte  array  out  to  a  tile,  the 
bent  is  in  reverse  order  too 


Here's  the  code  to  create  a  byt* 
array,  oyen  an  m?ut  stream,  and 

«addaS -to  bytes  0  through 

<£  the  array  - 


byte [ ]  greeting ; 

greeting  =  File. ReadAllBytes (filename) 


/ 


1  byte  variables 

roioiqioioioi 

0  1  Z  3+54 

72  101  108  108  111  33  33 


Jhese  numbers  are 
the  Unicode  numbers 
+«*-  the  charaef^w 
"Hello//"  1  "* 

Array .Reverse (greeting) ; 

File .WriteAllBytes (filename,  greeting) ; 


A/ow  the  bytes  are  in 
reverse  order. 


426  Chapter  9 


reading  and  writing  files 


Use  a  PmaryWriter  to  write  binary  data 


You  could  encode  all  of  your  strings,  chars,  ints,  and  floats  into  byte  arrays  before 
writing  them  out  to  files,  but  that  would  get  pretty  tedious.  That’s  why  .NET  gives  you 
a  very  useful  class  called  BinaryWriter  that  automatically  encodes  your  data 
and  writes  it  to  a  file.  All  you  need  to  do  is  create  a  FileStream  and  pass  it  into  the 
BinaryWriter’s  constructor.  Then  you  can  call  its  methods  to  write  out  your  data.  So  add 
another  button  to  your  program,  and  we'll  show  you  how  to  use  Binary YVriterQ. 


Start  by  setting  up  some  data  to  write  to  a  file. 

int  intValue  =  48769414; 
string  stringValue  =  "Hello!"; 
byte[]  byteArray  =  (  47,  129,  0, 
float  f loatValue  =  491.695F; 
char  charValue  =  'E' ; 


+ 

Do  tills! 

if  r  RfeGreaW),  it'll  start  a  new 
tW  s  there  already,  it'll  blow  it  away  and 
116  , ;  start  a  brand  new  one  There's  also  the  File 

f^rfaO  method,  which  opens  the  existing  one 
a"d  s^rts  overwrit, ng  it  fro*,  the  beginn.ng 

To  use  a  BinaryWriter.  first  you  need  to  open  a  new  stream  with  File.Grcate(): 

using  (FileStream  output  =  File. Create ("binarydata.dat") )  { 

BinaryWriter  writer  =  new  BinaryWriter (output) ; 

Now  just  call  its  WriteQ  method.  Each  time  you  do,  it  adds  new  bytes  onto  die  end  of  die  file 
that  contain  an  encoded  version  of  whatever  data  you  passed  it  as  a  parameter. 

writer  .Write  (intValue) ;  ^  tfrd*0  statement  erodes  one 

writer. Write  (stringValue)  j/  ^  ^  ty^s,  a„d  then  sends  -those 
writer  .Write  (byteArray) ;  bytes  to  the  FileStream  object  You  The  FileStream 

■  .i  -i  i —  -  j  writes  the  bytes  to 

the  end  of  the  file 


writer  .Write  (f  loatValue) ;  \  can  pass  it  any  value  type,  and  'til 

writer  .Write  (charValue) ;  )  encode  it  automatically 


Now  use  (he  same  code  you  used  liefbre  to  read  in  the  file  you  just  wrote. 


Sharp  your  pencil 


byte[]  dataWritten  =  File .ReadAllBytes ("binarydata.dat") ; 
foreach  (byte  b  in  dataWritten)  Here's  a  hint1  Strings  can  be 

Console. Write("(0:x2)  ",  b) ;  so  ^  string 

Console. WriteLine  ("  -  (0)  bytes",  dataWritten. Length) ;  ^||  hovTlong^it^T  /\Iso° 

j  you  Can  look  up  the  string 

and  Char  Unicode  values  using 

Write  down  the  output  in  the  blanks  below.  Can  you  figure  out  what  bytes  Character  Map 
correspond  to  each  of  the  five  'Write  ( )  statements?  Mark  each  group  of  bytes  with 
the  name  of  the  variable. 


bytes 
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an  amalgam  of  data 


•float  and  int  values  take  up  four  bytes  when 
you  write  them  to  a  file  |f  you’d  used  long  or 
double,  then  tKey'd  take  up  eight  bytes  each 


rpen  your  pencil 
Solution 


84  v\  c9  01  ok  Vi  45  he  he  k(  II  1(  SI  00  l*c  (k  d«  (9  Vk  'H  _  20  byte. 


7> 


rbn revalue  '  t>yt e$v-v-ayJ  floa-lValu^*  dhar\/alue 


The  f  irst  byte  in  the  string  is  t— that’s 
the  length  of  the  string  Mn  use 
Character  Map  to  look  up  each  of  the 
Characters  in  "Hello^”— it  starts  with 
W+OOA"@  and  ends  with  U +002.1 


Z1  if  y 

v —  talci 


ou  use  the  Windows 
Calculator  to  Convert  these 
bytes  from  he*  to  decimal,  you 
can  see  that  these  are  the 
numbers  in  byte  Array 


^  Char  holds  a  Unicode 
character,  and  ‘E’  only 
takes  one  byte— it's 
encoded  as  U+OOA^ 


Use  Piwaryiteader  to  read  the  data  back  in 

The  BinarvReader  class  works  just  like  BinaryYVriter.  You  create  a  stream, 
attach  the  BinaryReader  object  to  it,  and  then  call  its  methods.  But  the  reader 
doesn’t  know  what  data’s  in  the  file!  And  it  has  no  way  of  knowing. 

Your  float  value  of  491 . 695F  was  encoded  as  d8  f  5  43  45.  But  those 
same  bytes  are  a  perfectly  v  alid  int  1 , 1 40, 1 85,334.  So  you'll  need  to  tell  the 
BinaryReader  exactly  what  types  to  read  from  the  file.  Add  one  more  button 
to  your  form,  and  have  it  read  the  data  you  just  wrote. 

Start  out  by  setting  up  the  FileStream  and  Binarv  Reader  objects: 


Don  t  'take  our  word  for  ft- 
Replace  the  line  that  reads  the 
float  with  a  call  to  Read|nt320. 
f/ou  II  need  to  change  the  type 
of  floatRead  to  int)  Then  you 
can  see  for  yourself  what  it 
reads  from  the  file. 


using  (FileStream  input  =  File.OpenRead("binarydata.dat") )  { 
BinaryReader  reader  =  new  BinaryReader (input) ; 

You  tell  BinaryReader  what  type  of  data  to  read  by  calling  its  different  methods. 


int  intRead  =  reader .Readlnt32 () ; 
string  stringRead  =  reader .Readstring () ; 
byte[]  byteArrayRead  =  reader .ReadBytes (4) 
float  floatRead  =  reader .ReadSingle () ; 
char  charRead  =  reader . ReadChar () ; 


Each  value  type  has  its  own  method  in 
DmaryReaderO  that  returns  the  data 
•n  the  Correct  type.  Most  don’t  need 
any  parameters,  but  ReadBytesO  takes 
parameter  that  tells  BinaryReader 
how  many  bytes  to  read 


You  tell  BinaryReader  what  type  of  data  to  read  by  calling  its  different  methods. 

Console  .Write  (''int :  (0)  string:  (1}  bytes:  ",  intRead,  stringRead); 
foreach  (byte  b  in  byteArrayRead) 

Console. Write  (''(0)  ",  b) ; 

Console .Write ("  float:  (0)  char:  (1)  ",  floatRead,  charRead); 


Here’s  the  output  that  gets  printed  to  the  console: 

int:  48769414  string:  Hello!  bytes:  47  129  0  116  float:  491.695  char:  E 
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You  can  read  and  write  serialized  files  manually,  too 


Serialized  files  don't  look  so  pretty'  when  you  open  them  up  in  Notepad.  You'll  find  all  the 
files  you  write  in  your  project's  “bin/Debug”  folder — let's  take  a  minute  and  get  more 
acquainted  to  the  inner  workings  of  a  serialized  file. 

Serialize  two  Card  objects  to  different  files 

Use  the  serialization  code  you’ve  already  written  to  serialize  the  Three  of  Clubs  to  cardl .  dat  and 
Six  of  Hearts  to  card2  .  dat.  Check  to  make  sure  that  both  tiles  were  written  out  and  are  now  in  a 
folder,  and  that  they  both  have  the  same  tile  size.  Then  open  one  of  them  in  Notepad: 


4-  ^ 

rDo  tfns! 
^  + 


There  are 


some  words  in 
the  file  Hike 
"Chapterf , 
which  was  'the 
namespace  we 
used))  but 


P1  cardl  dat  -  Notepad  f^~|fD][X| 


Fte  Edit  Format  View  Help 

ij  U  yyyyO  00  ?Chapter9,  vers ion=l. 0. 0. 0,  Culture=neutraT,  | 

Publ icKeyToken=nul TOD  0Chapter9.Card0  DSuitQValueDDDChapter9.Card+SuitsD 

DChapter9.Card+ValuesD  0  D>yyyOChapter9.Card+SuitsD  Dvalue _  □□  □ 

0uyyy0Chapter9.Card+Values0  Ovalue _  DO  D  00  □  Oserial izer.Card+ValuesO  v 


it’s  . 
vnre 


mostly  <d\ 

adable  ^ 


Write  a  loop  to  compare  the  two  binary  files 

We  used  the  ReadByte()  method  to  read  the  next  byte  from  a  stream  it  returns  an  int  that  contains 
the  value  of  (hat  by  te.  We  also  used  the  stream’s  Length  field  to  make  sure  we  read  the  whole  file. 


byte[]  firstFile  =  File. ReadAllBytes ("cardl .dat") ; 
byte[]  secondFile  =  File. ReadAllBytes ("card2 .dat") ; 
for  (int  i  =  0;  i  <  firstFile. Length;  i++) 
if  (firstFile [i]  !=  secondFile [i] ) 

Console. WriteLine ("Byte  # { 0 } :  (1)  versus  {2}", 
i,  firstFile [i] ,  secondFile [i] ) ; 

This  loop  examines  -the  -first  byte  from  each  ot 
the  files  and  Compares  them,  then  the  second  byte, 
then  the  third,  et<L  liVhen  it  finds  a  di-ffirence,  it 
writes  a  line  to  the  Console 

di-fferent  byte  arrays,  so  they  can  . 

be  Compared  byte  by  byte  SinCe 

the  same  class  was  serialized  to  two  KM I  When  you  write  to  a  file,  you  don’t 

afferent  files,  they'll  be  almost  *f  t  T*  always  start  from  a  clean  slatel 

identical-  but  let's  see  just  careful  if  you  use  File.OpenWrite().  It 

identical  they  are  W91CH  11.  doesn't  delete  the  file — it  just  starts  overwriting 

the  data  starting  at  the  beginning.  That’s  why 
we  Ve  been  using  File.CreateQ — it  creates  a  new  file. 


We’re  not  done  yet— flip  tlie  page! 
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celebrate  our  differences 


Find  where  the  files  differ,  and  use 
that  information  to  alter  them 

The  loop  you  just  wrote  pinpoints  exactly  where  the  two  serialized 
Card  tiles  difler.  Since  the  only  difference  between  the  two  objects 
were  their-  Suit  and  Value  fields,  then  that  should  be  the  only  difference 
in  their  files,  too.  So  if  we  find  the  bytes  that  hold  the  suit  and  value, 
we  should  be  able  to  change  them  to  make  a  new  card  with 
whatever  suit  and  value  we  want! 


Take  a  look  at  the  console  output  to  see  how  the  two  files  differ 

The  console  should  show  that  two  bvtes  differ: 


Byte  #218:  1  versus  3 
Byte  #266:  3  versus  6 

That  should  make  a  lot  of  sense!  Go  back  to  the  Card.  Suits  enum  front  the  last  chapter,  and 
you’ll  find  that  value  for  Clubs  is  I  and  the  value  lor  Hearts  is  3,  so  that’s  the  first  difference.  And  the 
second  difference — six  versus  three — is  pretty  obviously  the  card’s  value.  You  might  see  different  byte 
numbers,  which  isn’t  surprising:  you  might  be  using  a  different  namespace,  which  would  change  the 
length  of  the  file.  r\ 

Remember  bow  the  namespace  was  included  as  pari  *1 

o+  ike  serialized  -file?  If  your  namespace  is  different  H-m,  f  byie  #2J«  m  ike  serialized  file 

iker,  ibe  byte  numbers  will  be  different  too.  '  L  ike  ^t,  iken  we  should  be  to 

-the  suit  of  the  eav-d  by  read  1*3  that  \  le 

in,  changing  that  ore  byte,  and  writing  &  «*t 
again  (Remember,  your  own  serialized  file  might 
store  the  suit  at  a  different  location  ) 


Write  code  to  manually  create  a  new  file  that  contains  King  of  Spades 

We’ll  take  one  of  the  arrays  that  we  read,  alter  it  to  contain  a  new  card,  and  write  it  bark  out. 


If  you  found 
different 
byte  numbers 
in  step  #3, 
substitute 
them  in  here. 


firstFil<f  [227  j\  =  (byte)Card.Suits.Spades; 
firstFila^27jj/  =  (byte) Card. Values .King; 

File. Delete ("card3.dat") ; 

File.WriteAllBytes("card3.dat",  firstFile) ; 

Now  deserialize  the  card  from  card.3  .  dat  and  see  if  it's  the  King  of  Spades! 


% 

Now  that  you  know  which  bytes 
Contain  the  suit  and  value,  you 
can  change  just  those  bytes 
in  the  array  before  it  gets 
written  out  to  card3.dat 
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Working  with  binary  files  can  be  tricky 


W’liat  do  you  do  if  you  have  a  file  and  you  aren’t  quite  sure  what’s  inside  it?  You  don’t 
know  what  application  created  it.  and  you  need  to  know  something  about  it — but  when 
you  open  it  in  Notepad,  it  looks  like  it  bunch  of  garbage.  What  if  you’d  exhausted  all 
vour  other  options,  and  really  needed  to  just  look  inside?  Looking  at  that  picture,  it's 
pretty  clear  that  Notepad  just  isn’t  the  right  tool. 

'Heve  $  -the  serialized  card,  opened  up  in 
Notepad  Thats  not  going  -to  be  useful  at  all 


B  cardl . dat  -  Notepad 


BE® 


Fte  Edit  Fermat  View  Hep 

Hu  ,•;/,>  U  00  ?Chapter9,  ers  ion=l .  0. 0. 0,  Culture=neutral , 

IPubl icKeyToken=null00  OChapter9.CardO  0Suit0Value000Chapter9.Card+SuitsD 

]0Chapter9.Card+Values0  0  OyywOChapter9.Card+SuitsO  Ovalue _  00  0 

Oval ue _  00 


0uyyy0Chapter9 . Card+Val ues  0 


00 


□serial izer. Card+Val  ues 0  „ 


There’s  another  option — it’s  a  format  called  a  “hex  dump”,  and  it’s  a  pretty  standard  way  to  look  at 
binary  data.  It's  definitely  more  informative  than  looking  at  the  file  in  Notepad.  Hexadecimal  or 
“hex”-  is  a  convenient  way  to  display  bytes  in  a  file.  Every  byte  takes  2  characters  to  display  in  hex,  so 
you  can  see  a  lot  of  data  in  a  really  small  space,  and  a  format  that  makes  it  easy  to  spot  patterns.  Also, 
it’s  useful  to  display  binary  data  in  rows  that  are  8,  16,  or  32  bytes  long  because  most  binary  data  tends 
to  break  down  in  chunks  of  4,  8,  16,  or  32... like  all  the  types  in  C#.  For  example,  an  int  takes  up  4 
by  tes,  and  is  4  bytes  long  when  serialized  on  disk.  Here’s  what  that  same  file  looks  like  its  a  hex  dump, 
using  one  of  any  number  of  free  hex  dump  programs  available  for  Windows: 


t  - 

see  the  numeric 
value  of  each  byte 
in  the  file 


The  number  at  the 
beginning  of  each 
line  is  the  ©#set 
(or  distance  into  the 
■file)  of  the  first 
byte  in  the  line. 
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01 

00 

er  Card+Ualues. 

i 

0130 

00 

oc 

07 

76 

61 

Gc 

75 

65 

5f 

5f 

00 

08 

02 

00 

60 

00 

. .  ualue  . 

0110. 

03 

00 

00 

0b 

i 

/ou  still 
get  to  see 
the  original 
text,  but 
the  garbage 
characters 
are  stripped 
out 
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69  73  6e  27  74  20  74  68  69  73  20  66  75  6e  3f  Oa 


Use  file  streams  to  build  a  hex  dumper 

A  hex  dump  is  a  hexadecimal  view  of  the  contents  of  a  lile,  and  it’s 
a  really  common  way  for  programmers  to  take  a  deep  look  at  a  file’s 
internal  structure.  Most  operating  systems  ship  with  a  built-in  Itex 
dump  utility.  Unfortunately.  W  indows  doesn’t.  So  let’s  build  one! 


How  to  wake  a  hex  dump 

Start  with  some  familiar  text: 


We  the  people  of  the  United  States,  in  order  to  form  a  more  perfect  union... 


Here’s  what  a  Itex  dump  of  that  text  would  look  like: 

^gain,  you  can  immediately  sec  "the 
numeric  value  of  each  byte  in  the  file> — . 


0000: 

57 

65 

20 

74 

68 

65( 

2s; 

•  70  -- 

65 

6f 

70 

6c 

65 

20 

6f 

66 

0010: 

20 

74 

68 

65 

20 

55 

6e 

69  — 

74 

65 

64 

20 

53 

74 

61 

74 

0020: 

65 

73 

2c 

20 

69 

6e 

20 

6f  — 

72 

64 

65 

72 

20 

74 

6f 

20 

0030: 

66 

6f 

72 

6d 

20 

61 

20 

6d  — 

6f 

72 

65 

20 

70 

65 

72 

66 

(FoTDy 

65 

63 

74 

20 

75 

6e 

69 

6f  — 

6e 

2e 

2e 

2e 

We  II  add  the  number  at  the  beginning  of  each  line  by  using 
the  offset  of  the  -first  byte  in  the  line 


We  the  people  of 
the  United  Stat 
es,  in  order  to 
form  a  more  perf 
ect  union . . . 


Each  of  those  numbers — 57,  65,  6F — is  the  value  of  one  byte  in  the  lile.  The  reason  some  of  the  “numbers” 
have  letter  values  is  that  they’re  hexadecimal  (or  hex).  That’s  just  another  way  of  writing  a  number.  Instead  of 
using  ten  digits  from  0  to  9,  it  uses  sixteen  digits  from  0  to  9  plus  the  letters  A  through  F. 


/\nd  we  II 
need  to 
replace  the 
garbage 
Characters 
with  periods. 


Each  line  in  our  hex  dump  represents  sixteen  characters  in  the  input  dial  was  used  to  generate  it.  In  our 
dump,  the  first  four  characters  are  the  offset  in  the  file  the  first  line  starts  at  character  0,  the  next  at 
character  16  (or  hex  10),  then  character  32  (hex  20),  etc.  (Other  hex  dumps  look  slightly  different,  but  this 
one  will  do  for  us.) 


Working  with  hex 


You  can  put  hex  numbers  directly  into  your  program  just  add  the 
characters  Ox  in  front  of  the  number: 

int  j  =  0x20; 

MessageBox . Show ("The  value  is  "  +  j); 

W  hen  you  use  the  +  operator  to  concatenate  a  number  into  a 

string,  it  gets  converted  to  decimal.  You  can  use  the  static  String.  String.  Foe  mat  0  uses  parameters 

Format  ( )  method  to  convert  your  number  to  a  hex-formatted  ^e  ConsolefVnteLineO,  so  you 

string  instead:  »  ^  "ced  to  learn  anything  new 

to  use  ft 

string  h  =  String . Format ("{ 0 :x2 } j); 
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StreamReader  and  StreamWriter  will  do  just  fine 

Our  hex  dumper  will  write  its  dump  out  to  a  lile,  and  since  it's  just  writing  text  a 
StreamWriter  will  do  just  fine.  But  we  can  also  take  advantage  of  the  ReadBlock() 
method  in  StreamReader.  It  reads  a  block  of  characers  into  a  char  array — you  specify' 
the  number  of  characters  you  want  to  read,  and  it'll  either  read  that  many  characters 
or,  if  there  are  fewer  than  that  many  left  in  the  file,  it'll  read  the  rest  of  the  file.  Since 
we’re  displaying  16  characters  per  line  we'll  read  blocks  of  16  characters. 

So  add  one  more  button  to  your  program— add  this  hex  dumper  to  it.  Change  the  first 
two  lines  so  that  they  point  to  real  files  on  your  hard  drive.  Start  with  a  serialized  Card 
file.  Then  see  if  you  can  modify  it  to  use  the  Open  and  Save  As  dialog  boxes. 


int  position  =  0; 


using  (StreamReader  reader  =  new  StreamReader (@"c: \files\inputFile. txt") ) 
using  (StreamWriter  writer  =  new  StreamWriter (@"c: \f iles\outputFile . txt" ,  false)) 

{  f\  StreamReader's  Endof Stream  field  returns  false 

if  there  are  characters  still  left  to  read  in  the  fie 

•  1  , 1  ^  v  ,  This  ReadBlockO  call  reads  up  to  I* 

while  dreader. EndOf Stream)  <  characters  ,nto  a  char  array  ) 

char  [  ]  buffer  =  new  char  [16]  _ _ _ _ _ \  '  J  The  static  StringFormat 

int  charactersRead  =  reader.  ReadBlock  (buffer,  0,  16);  z'  method  Converts  numbers 
writer  .Write  ("( 0  )  :  ",  String .  Format  ("{ 0 :  x4 )" ,  position));  k  strings, 

position  +=  charactersRead; 

^,for  (int  i  =  0;  i  <  16;  i++)  ( 

(  if  (i  <  charactersRead)  { 

This  loop  goes  string  hex  =  String.  Format  ("{ 0  :x2 } ", 


fs'  FormatO  to  print  the 

second  parameter-in  this 


through  the 
Characters 
and  prints 

each  of  them  else 
to  a  line  in 
the  output 


writer .Write (hex  + 


writer .Write (' 


Some  Characters  with  an  value 
under  VI  don’t  print,  so  v* 

•),  „Tlaee  all  the-  ^ 


if  (i  ==  7)  {  writer. Write ("—  ”)  ;  } 
if  (buffer [i]  <  32  ||  buffer[i]  >  250) 


£ase,  position— as  a 
Character  hex  number, 
(byte) buf fer [i] ) ; 

You  Can  Convert  a 
charf]  array  to 
a  string  by  passing 
't  to  the  overloaded 
Constructor  •for 
string. 


{  buffer [i]  = 


} 


buf ferContents . Substring (0 ,  charactersRead) ) 

ii  j  J.L.U.  a  du/j  of  the 


) 

string  buf ferContents  =  new  string (buffer) ; 
writer .WriteLine (”  "  + 

Every  string  has  a  substring  method  that  returns  a  p.eCe  o+  the 
14  k  thh  e*e,  *  the  f ^  ch,ra=tarsRe,d  garter 

4*4.  at  the  be*.--)  <p*ti»  01  (Uok  baek  at  the  faff  the  l~r 
t»  ,ee  where  charactersRead  «  eet-the  ReadBlock  0 
returns  the  number  of  characters  that  it  read  into  the  array 


you  are  here  ► 
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no  dumb  questions 


V:  Why  didn't  I  have  to  use  the 
Close  ( )  method  to  close  the  file  after 
I  used  File  .  ReadAllText  ( )  and 
File . WriteAllText ( ) ? 

The  File  class  has  several  very 
useful  static  methods  that  automatically 
open  up  a  file,  read  or  wnte  data,  and 
then  close  it  automatically  In  addition 
to  the  ReadAllText  ()  and 
WriteAllText  ()  methods, 
there  are  ReadAl  lBytes  ( )  and 
WriteAllBytes  ( )  thatworkwith 
byte  arrays,  and  ReadAllLines  ( ) 
and  WriteAllLines  ( ) ,  which  read 
and  wnte  string  arrays,  where  each  string  in 
the  array  is  a  separate  line  in  the  file.  All  of 
these  methods  automatically  open  and  dose 
the  streams,  so  you  can  do  your  whole  file 
operation  in  a  single  statement 

Oj 

If  the  Files  tream  has  methods 
for  reading  and  writing,  why  do  I  ever 
need  to  use  StreamReader  and 
StreamWriter? 

The  FileStream  class  is  really 
useful  for  reading  and  writing  bytes  to  binary 
files.  Its  methods  for  reading  and  writing 
operate  with  bytes  and  byte  arrays  But  a 
lot  of  programs  work  exclusively  with  text 
files— like  the  first  version  of  the  Excuse 
Generator,  which  only  wrote  strings  out  to 
files.  That's  where  the  StreamReader 
and  StreamWriter  come  in  really 
handy.  They  have  methods  that  are  built 
specifically  for  reading  and  writing  lines  of 
text.  Without  them,  if  you  wanted  to  read  a 
line  of  text  in  from  a  file,  you'd  have  to  first 
read  a  byte  array  and  then  write  a  loop  to 
search  through  that  array  for  a  linebreak— so 
it's  easy  to  see  how  they  make  your  life 
easier. 


tliereiare  no 

Dumb  Questions 


Q: 


When  should  I  use  File,  and 
when  should  I  use  Filelnfo? 


The  main  difference  between  the 
File  and  Filelnfo  classes  is  that  the 
methods  in  File  are  static,  so  you  don’t 
need  to  create  an  instance  of  them.  On  the 
other  hand,  Filelnfo  requires  that  you 
instantiate  it  with  a  filename  In  some  cases, 
that  would  be  more  cumbersome,  like  if  you 
only  need  to  perform  a  single  file  operation 
(like  just  deleting  or  moving  one  file).  On 
the  other  hand,  if  you  need  to  do  many  file 
operations  to  the  same  file,  then  it’s  more 
efficient  to  use  Filelnfo,  because 
you  only  need  to  pass  it  the  filename  once. 
You  should  decide  which  one  to  use  based 
on  the  particular  situation  you  encounter. 

In  other  words,  if  you're  doing  one  file 
operation,  use  File.  If  you're  doing  a  lot  of 
file  operations  in  a  row,  use  Filelnfo. 


Qj  Back  up  a  minute.  Why  was 
“Eureka!”  written  out  with  one  byte  per 
character,  but  when  I  wrote  out  the 
Hebrew  letters  they  took  up  two  bytes? 
And  what  was  that  “FF  FE”  thing  at  the 
beginning  of  the  bytes? 

What  you're  seeing  is  the  difference 
between  two  closely  related  Unicode 
encodings.  Plain  English  letters,  numbers, 
normal  punctuation  marks,  and  some 
standard  characters  (like  curly  brackets, 
ampersands,  and  other  things  you  see  on 
your  keyboard)  all  have  very  low  Unicode 
numbers— between  0  and  127.  (If  you’ve 
used  ASCII  before,  they’re  the  same  as  the 
ASCII  characters.)  If  a  file  only  contains 
those  Unicode  characters  with  low  numbers, 
it  just  prints  out  their  bytes. 


Things  get  a  little  more  complicated 
when  you  add  higher-numbered  Unicode 
characters  into  the  mix.  One  byte  can  only 


hold  a  number  between  0  and  255.  But  two 
bytes  in  a  row  can  store  numbers  between  0 
and  65,536— which,  in  hex,  is  FFFF.  The  file 
needs  to  be  able  to  tell  whatever  program 
opens  it  up  that  it's  going  to  contain  these 
higher-numbered  characters  So  it  puts 
a  special  reserved  byte  sequence  at  the 
beginning  of  the  file  “FF  FE".  That’s  called 
the  “byte  order  mark".  As  soon  as  a  program 
sees  that,  it  knows  that  all  of  the  characters 
are  encoded  with  two  bytes  each.  (So  an  E 
is  encoded  as  00  45— with  leading  zeroes.) 

Qj  Why  is  it  called  a  byte  order  mark? 

Remember  how  your  bytes  were 
reversed?  Shin's  Unicode  value  of  U+05E9 
was  written  to  the  file  as  E9  05.  That’s  called 
‘little  endian”.  Go  back  to  the  code  that  wrote 
out  those  bytes  and  add  a  third  parameter  to 
WriteAIIText():  Encoding.BigEndianUmcode. 
That  tells  it  to  write  the  data  out  in  “big 
endian",  which  doesn’t  flip  the  bytes  around. 
You'll  see  the  bytes  come  out  as  “05  E9"  this 
time.  You'll  also  see  a  different  byte  order 
mark:  “FE  FF".  And  your  Simple  Text  Editor 
is  smart  enough  to  read  both  of  them! 

II  you’re  writing  a 
string  that  only  has 
Unicode  characters 
with  low  numbers,  it 
writes  one  hyte  per 
character.  But  il  it’s 
got  high -numbered 
characters,  they’ll 
he  written  using  two 
bytes  each. 
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Change  Brian's  Excuse  Generator  so  it  uses  binary  files  with  serialized  Excuse  objects 
instead  of  text  files. 


O 

O 

o 


Make  the  Excuse  class  serializable 

Mark  the  Excuse  class  with  the  [Serializable]  attribute  to  make  it  serializable. 
Also,  you'll  need  to  add  the  using  line: 

using  System. Runtime . Serialization . Formatters . Binary; 


Change  the  Excuse. Save()  method  to  serialize  the  excuse  What  keyword 

When  the  Save()  method  writes  a  file  out  to  the  (older,  instead  of  using  - - .  ^  uSf  ,hSlC|e  ^ 

Stn  am Writer  to  write  the  file  out,  have  it  open  a  file  and  serialize  itself  out.  a  c|ass 

You’ll  need  to  figure  out  how  the  current  class  can  deserialize  itself.  ee-f erenCe  to  itsel-f? 


Change  the  Excuse. OpenFile()  method  to  deserialize  an  excuse 

You’ll  need  to  create  a  temporary  Excuse  object  to  deserialize  front  the  file,  and 
then  copy  its  fields  into  the  current  class. 


Now  just  change  the  form  so  it  uses  a  new  file  extension 

There’s  just  one  very  small  change  you  need  to  make  to  the  form.  Since  we’re 
no  longer  working  with  text  files,  we  shouldn't  use  the  .  txt  extension  any  more. 
Change  the  dialog  boxes,  default  filenames  and  directory  search  code  so  that 
they  work  with  *  .  excuse  files  instead. 


Wow,  that  was  really  easy!  All  the  code  for  saving  and 
opening  excuses  was  inside  the  Excuse  class.  I  just  had  to 
change  the  class— I  barely  had  to  touch  the  form  at  all.  It's  like  the 
form  doesn't  even  care  how  the  class  saves  its  data.  It  just  passes  in 
the  filename  and  knows  everything  will  get  saved  properly. 


That’s  right!  Your  code  was  very  easy  to  change 
because  the  class  was  well  encapsulated. 

When  you've  goi  a  class  dial  hides  its  internal  operations  from 
the  rest  of  the  program  and  only  exposes  the  behavior  that  needs 
to  be  exposed,  it’s  called  a  well  encapsulated  class,  in  the 
Excuse  Manager  program,  the  form  doesn't  have  any  information 
about  how  excuses  are  saved  to  files.  It  just  passes  a  filename  into 
the  excuse  class,  mid  the  class  takes  care  of  the  rest.  That  makes 
it  very  easy  to  make  big  changes  to  how  your  class  works  with 
files.  The  1  letter  you  encapsulate  your  classes,  the  easier  they  are 
to  alter  later  on. 


Remember  bow 
encapsulation  was 
one  of  the  tour 
tort  OOP  principles? 
Here's  an  example 
of  bow  using  those 
principles  makes  your 
programs  better. 


you  are  here  ► 
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Change  Brian's  Excuse  Generator  so  it  uses  binary  files  with  serialized 
,  Excuse  objects  instead  of  text  files.  Y°v  on ly  need  to  change  these  four  lines  in  the  fomc 

Ex$RCtS$  two  lines  in  the  save  button's  Clitk  event,  and  two  in 

Solution  the  open  button  s— they  just  change  the  dialogs  to  use 

the  excuse  extension 

private  void  save_Click (object  sender,  EventArgs  e)  { 

//  existing  code 

saveFileDialogl . Filter  =  "Excuse  files  (*. excuse) | * .excuse | All  files  (*.*)!*.*"; 
saveFileDialogl . FileName  =  description. Text  +  ".excuse"; 

//  existing  code  / 


. excuse” 


private  void  save_Click (object  sender,  EventArgs  e)  { 

//  existing  code 

openFileDialogl . Filter  = 

"Excuse  files  (* .excuse)  I  * .excuse | All  files  (*.*)!*•* 
openFileDialogl . FileName  =  description. Text  +  ".excuse" 

II  existing  code  ^ 


Standard  save  and 
open  dialog  Wes  do 
the  tr«*  here 


[Serializable] 
public  class  Excuse  f 

public  string  Description; 
public  string  Results; 
public  DateTime  LastUsed; 
public  string  ExcusePath; 
public  Excuse ()  ( 

ExcusePath  =  ""; 


The  only  change  to  the  torn, 
•s  to  have  it  change  the  tile 
extension  it  passes  to  the 
Excuse  class. 


public  Excuse (string  excusePath)  { 

OpenFile (ExcusePath) ; 

) 

public  Excuse (Random  random,  string  folder)  {  _ 

string!]  fileNames  =  Directory .GetFiles (folder,  "‘.excuse");  y 
OpenFile (fileNames [random. Next (fileNames .Length) ]) ;  ,  i 


private  void  OpenFile (string  excusePath)  ( 
this. ExcusePath  =  excusePath; 

BinaryFormatter  formatter  =  new  BinaryFormatter ( ) ; 
Excuse  tempExcuse; 

using  (Stream  input  =  File.OpenRead (excusePath) )  { 

tempExcuse  =  (Excuse) formatter .Deserialize (input) , 

) 

Description  =  tempExcuse. Description; 

Results  =  tempExcuse . Results; 

LastUsed  =  tempExcuse . LastUsed; 


The  Constructor  for  loading 
rand  on,  excuses  needs  to  look 
.for  -the  "  excuse”  ex-tension 
instead  of  “*  txt”  files. 


public  void  Save (string  fileName)  ( 

BinaryFormatter  formatter  =  new  BinaryFormatter () ; 
using  (Stream  output  =  File .OpenWrite (fileName) )  { 

formatter  .Serialize  (output,  ^rfiispr  yye  pass  in  "this” 

j  because  we  want  this 

class  to  be  serialised- 
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6  The  method  in  the  File  class  that  checks  whether  or  not  a  specific 
file  is  on  the  dnve 

9.  This  statement  indicates  the  end  of  a  case  inside  a  switch  statement 

10  The  abstract  class  that  FileStream  inherits  from 

11 .  A  non-visual  control  that  lets  you  pop  up  the  standard  Windows 

“Save  As’  dialog  box 

15.  How  you  write  numbers  in  base-16 

16  If  you  don’t  call  this  method,  your  stream  could  be  locked  open  so 

other  methods  or  programs  can't  open  it 

17,  The  StreamReader  method  that  reads  data  into  a  charQ  array 

18  An  encoding  system  that  assigns  a  uniue  number  to  each  character 

19.  Use  this  statement  to  indicate  which  statements  should  be 

executed  when  the  value  being  tested  in  a  switch  statement  does  not 

match  any  of  the  cases 


1 .  This  class  has  a  method  that  writes  any  value  type  to  a  file 
2  The  static  method  in  the  Array  class  that  turns  an  array  backwards 
3.  The  event  handler  that  gets  run  whenever  someone  modifies  the 
data  in  an  input  control 

4  This  class  has  many  static  methods  that  let  you  manipulate  folders 
5.  Using  this  OOP  principle  makes  it  a  lot  easier  to  maintain  your  code 

7.  If  you  don't  use  this  attnbute  to  indicate  that  a  class  can  be  wntten  to 
a  stream,  BinaryFormatter  will  generate  an  error 

8.  This  BinaryFormatter  method  reads  an  object  from 
a  stream 

12.  \n  and  \r  are  examples  of  this  kind  of  sequence 

13.  This  class  lets  you  perform  all  the  operations  in  the  File  class  for  a 
specific  file 

14.  This  method  sends  text  to  a  stream  followed  by  a  line  break 
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Filecross 

Solution 
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4 


4- 


Putting  out  fires  gets  old  + 


Programmers  aren’t  meant  to  be  firefighters. 

You've  worked  your  tail  off,  waded  through  technical  manuals  and  a  few  engaging 
Head  First  books,  and  you’ve  reached  the  pinnacle  of  your  profession:  master 
programmer  But  you’re  still  getting  pages  from  work  because  your  program 
crashes,  or  doesn’t  behave  like  it’s  supposed  to  Nothing  pulls  you  out  of  the 
programming  groove  like  having  to  fix  a  strange  bug  .  but  with  exception  handling, 
you  can  wnte  code  to  deal  with  problems  that  come  up  Better  yet,  you  can  even 
react  to  those  problems,  and  keep  things  running 


this  is  a  new  chapter  439 


mo' programs  mo' problems 


Prian  needs  his  excuses  to  be  mobile 

Brian  recently  got  reassigned  to  the  international  division.  Now 
he  flies  all  over  the  world.  But  he  still  needs  to  keep  track  of  his 
excuses,  so  he  installed  the  program  you  built  on  his  laptop,  and 
takes  it  with  him  everywhere. 


r 

Same  o'1  Brian  „ 
always  looking  W 
an  excuse 
out  of  work 


Brian  s  ijo-t  the  excuse 
Senerator  vunnina  on 
his  laptop 


M  the  program  isn't  working! 

Brian  clicks  the  “Random  Excuse”  button,  and  gets  a  pretty  nasty 
looking  error.  Something  about  not  finding  his  excuses.  What  gives? 


fa  unbundled 
exception  must 
have  been  a 

problem  we  didn  t 
attount  for 


Excuse  Manager 


© 


Unhanded  exception  has  occurred  in  your  application  It  you  cbck 
Continue,  the  application  will  ignore  this  error  and  attempt  to  continue  If 
you  dick  Quit,  the  application  will  close  immediately 

Index  was  outside  the  bounds  of  the  airay 


E 


Details 


Continue 


Quit 
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jjharpen  your  pencil 


Here's  another  example  of  some  broken  code.  There  are  five  different  exceptions 
that  this  code  throws,  and  the  error  messages  are  shown  on  the  right.  It's  your 
job  to  match  the  line  of  code  that  has  a  problem  with  the  exception  that  line 
generates.  Read  the  exception  messages  fora  good  hint. 

public  static  void  BeeProcessor  ()  (  )( 

object  myBee  =  new  HoneyBee (36 . 5,  "Zippo");  Calling  double  fVse^2^  will 

float  howMuchHoney  =  (float) myBee;  ^arse  a  string  re 

double  value,  like  32- 


HoneyBee  anotherBee  =  new  HoneyBee (12 . 5,  "Buzzy") 
double  beeName  =  double. Parse (anotherBee. MyName) ; 

double  totalHoney  =  36.5  +  12.5; 
string  beesWeCanFeed  = 

for  (int  i  =  1;  i  <  (int)  totalHoney;  i++)  { 

beesWeCanFeed  +=  i .ToString ( ) ; 

} 

float  f  = 

float . Parse (beesWeCanFeed) ; 


r\  Over flowExcept ion  was  unhandled  QlJ 

Value  was  either  too  large  or  too  small  for  a  Single. 


int  drones  =4;  1“ 

O 

int  queens  =0;  l_ 

int  dronesPerQueen  =  drones  /  queens; 

anotherBee  =  null;  j\  InvalklCc 


]_  NullReferenceExceptlon  was  unfrandled 

Object  reference  not  set  to  an  Instance  of  an  object 


>\  InvalklCastException  was  unhandled 

Specified  cast  Is  not  valid. 

\ 

anotherBee . DoMyJob ( ) ; 

}  -  - 

\WVn  you  have  a  DivideByZeroExceptloo  was  unhandled 

reference  -that  Attempted  to  divide  by  zero. 

doesn't  point  to  a,y  Troubleshooting  tips; 
object,  it  gets  a 

special  value  tailed  Get  general  help  for  this  exception. 

null.  Setting  a 

reference  to  null,  Search  for  more  Help  Onine... 
tells  C#  it  doesn't 
point  to  anything 

t\  FormatException  was  unhandled 

Input  string  was  not  In  a  correct  format 

Troubleshooting  tips:  _ _ _ _ 

pMake  sure  your  method  arguments  are  n  the  right  format,  i 

When  converting  a  stmg  to  DateTime,  parse  the  stmg  to  take  the  date  before  putting  each  variable  into  the  DateTime  object. 
Get  general  help  for  the  exception, 

Search  for  more  Help  Online. . . 
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_  f^Jbarpen  your  pencil 
Solution 


Your  job  was  to  match  the  line  of  code  that  has  a 
problem  with  the  exception  that  line  generates. 


object  myBee  =  new  HoneyBee (36 . 5,  "Zippo"), 
float  howMuchHoney  =  (float)myBee; 


C#  K,s  no  idea  how  -to  east  a  HoneyBee 
obiect  to  a  and  trying  to  do  -t  w.l 

e/use  an  |nvalidCast£*teytion. 


;\  InvalidCastException  was  unhandled 

X 

Specified  cast  ts  not  valid. 

HoneyBee  anotherBee  =  new  HoneyBee (12 . 5,  "Buzzy")  ;s 
double  beeName  =  double . Parse (anotherBee .MyName) ; 


The  Parse 0  method  wants  you 
to  Jive  it  a  string  in  a  Certain 
tor  mat  Buz-z_y"  ish'£  j  string 
it  knows  how  to  Convert  to  a 
'number  That's  why  it  throws 
a  rormatExCeption. 


J\  FormatException  was  unhandled 

Input  stmg  was  not  n  a  correct  format. 

Trotijleshootlng  tips: 

jMake  sure  your  method  arguments  are  in  the  ricfit  format,  i 

When  converting  a  string  to  DateTime,  parse  the  string  to  take  the  date  before  putting  each  variable  nto  the  DateTime  object. 
Get  general  help  for  this  exception. 

Search  for  more  he£  Onlne... 


double  totalHoney  =  36.5  +  12.5; 
string  beesWeCanFeed  =  kT 

for  (int  i  =  1;  i  <  (int)  totalHoney;  i++)  ( 
beesWeCanFeed  +=  i .ToString  ( ) ; 

) 

float  f  =  f loat. Parse (beesWeCanFeed) ; 


-The  for  loop  will  Create  a  string  called 
beesWeCanFeed  that  contains  a  number  w^h  over 
to  digits  in  it  There's  no  way  a  float  can  hold 
a  number  that  big  a*i  trying  to  tram  ,t  into 
float  will  throw  an  0verflowE*Ceftion 


t\  OverflowException  was  unhandled 

Value  was  either  too  large  or  too  small  for  a  Single. 


ybu'd  never  actually  get  all  these  exceptions 
in  a  row.  The  program  would  throw  the  f  irst 
exception  and  then  stop  You'd  only  get  to 
the  second  exception  if  you  fixed  the  first- 
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l-fc’s  really  easy  to  throw  a 

PivideByZc'roExeeptioh  Just 

divide  any  number  by  -zero. 


t\  DivideByZeroException  was  unhandled 

X 

Attempted  to  divide  by  zero. 

Troubleshooting  tips: 

I II  Make  sure  the  value  of  the  denominator  is  not  zero  be 

iforG  performing 

a  division  operation,  i 

Get  general  help  for  the  exception. 

V 

Search  for  more  help  Online, . . 

int  drones  =  4; 
int  queens  =  0; 

int  drones PerQueen  =  drones  /  queens; 


Dividing  any  "umber  by  «ro  always  throws  this  k.nd  of  Caption.  Even  if  you 
don't  know  the  value  of  queens,  you  tan  prevent  it  just  by  decking  the  value  to 
make  sure  it's  not  rero  before  you  divide  it  into  drones 


anotherBee  =  null; 
if  (dronesPerQueen  <  10)  { 
anotherBee . DoMyJob ( ) ; 

) 


Setting  the  anotherBee  referente  variable  egual  to 
null  tells  C#  that  it  doesn’t  point  to  anything  So 
instead  of  pointing  to  an  objett,  it  points  to  nothing. 
Throwing  a  NullReferenteExteption  is  C#'s  way  of 
telling  you  that  there's  no  object  whose  Do/VJyJobO 
method  can  be  called 


That  DivideByZero  error  didn’t  have  to  happen.  You  can  see  just  by  looking 
at  the  code  that  there’s  something  wrong.  The  same  goes  for  the  other 
exceptions.  These  problems  were  preventable — and  the  more  you  know 
about  exceptions,  the  better  you’ll  be  at  keeping  your  code  from  crashing. 


you  are  here  ► 
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mmm  fudge 


When  your  program  throws  an  exception, 
.NET  generates  an  Exception  object. 


You’ve  been  looking  ai  .NET's  way  of  telling  you  something  went 
wrong  in  your  program:  an  exception.  In  C#,  when  an  exception 
occurs,  an  object  is  created  to  represent  the  problem.  It’s  called,  no 
surprise  here.  Exception. 

For  example,  suppose  you  have  an  array  with  four  items.  Then,  you  try 
and  access  the  sixteenth  item  (index  15,  since  we're  zero-based  here): 


int  anArray  =  {3,  4,  1,  11}; 
int  aValue  =  anArray [15]; 


This  Code  is 
obviously  going  -bo 
cause  problems. 


ex-cep-tion,  noun. 

a  person  or  thing  that  is 
excluded  from  a  general 
statement  or  does  not 
follow  a  rule.  While  Jim 
usually  hates  peanut  butter,  he 
made  an  exception  for  hen's 
peanut  butter  fudge. 


As  soon  as  y our  program  runs 
info  an  unhandled  exCep-fcion,  ^ 
generates  an  object  with  CePtio n  o'1 

all  the  data  it  has  about  it  1 


The  exception  object  ha 

message  that  tells  you  what  s 
message  \  ^  ^ 

wrong  and  a  ©* 

tails  that  made  to  the 

tLt  that  «»*<!  «« 


/ou  can  see  this  detail 
by  clicking  on  the  1/iew 
Detail  link  in  the  unhandled 
exception  window  ** 


Exception  snapshot: 

□ 

System,  ImjexOutCrfBangetxception 

{"Index  was  outside  the  bounds  of  the  array.*} 

[Sytfem.InxJexOutCrfRvoeExcetition] 

{Index  was  outside  the  bounds  erf  the  array.*} 

S  Data 

{System. ColecbonslistC^ctionarylnternal} 

HHpUnk 

mi 

Innerlxception 

mi 

(index  was  outside  the  bounds  cf  the  array.’  v 

Source 

*codeforch9* 

StadxTrace 

*  at  coderforch9. Program. Man<Strng(]  args)  ft  C:\\Docu 

0  TargetSite 

{Vend  MantSystem  SthngfDf 

1 _ °*  1 

.NET  goes  to  the  trouble  of  creating  an  object  because  it  wants  to  give  you  all 
the  information  about  what  caused  the  exception.  You  may  have  code  to  fix. 
or  you  may  just  need  to  make  some  changes  to  how  you  handle  a  particular 
situation  in  your  program. 

In  this  case,  an  IndexOutOfRangeException  indicates  you  have  a  bug: 
you're  trying  to  access  an  index  in  the  array  that’s  out  of  range.  You’ve  also  got 
information  about  exactly  where  in  the  code  the  problem  occurred,  making  it 
easy  to  track  down  the  problem  (even  if  you’ve  got  thousands  of  lines  of  code). 
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Dumb  ( 

o- 

vv^-  Why  are  there  so  many  kinds  of  exceptions? 

There  are  all  sorts  of  ways  that  you  can  write  code  that 
C#  simply  doesn't  know  how  to  deal  with.  It  would  be  difficult 
to  troubleshoot  your  problems  if  your  program  simply  gave  a 
generic  error  message  (“A  problem  occurred  at  line  37").  It’s  a 
lot  easier  to  track  down  and  fix  problems  in  your  code  when  you 
know  specifically  what  kind  of  error  occurred. 

o 

vv^,«  So  what  is  an  exception,  really? 

J\'.  It's  an  object  that  NET  creates  when  there's  a  problem 
(more  about  that  in  a  minute). 

Qj  Wait,  what?  It's  an  object? 

Yes,  an  exception  is  an  object.  The  properties  in  the 
object  tell  you  information  about  the  exception.  For  example,  it’s 
got  a  Message  property  that  has  a  useful  string  like  “Specified 
cast  was  invalid”  and  ‘Value  was  either  too  large  or  too  small 
for  a  Single",  which  is  what  it  used  to  generate  the  exception 
window.  The  reason  that  NET  generates  it  is  to  give  you  as 
much  information  as  it  can  about  exactly  what  was  going  on 
when  it  executed  the  statement  that  threw  the  exception 

o- 

Okay,  I  still  don’t  get  it.  Sorry.  Why  are  there  so  many 
different  kinds  of  exceptions,  again? 

Because  there  are  so  many  ways  that  your  code  can  act 
in  unexpected  ways  There  are  a  lot  of  situations  that  will  cause 
your  code  to  simply  crash.  It  would  be  really  hard  to  troubleshoot 
the  problems  if  you  didn’t  know  why  the  crash  happened. 

By  throwing  different  kinds  of  exceptions  under  different 
circumstances,  NET  is  giving  you  a  lot  of  really  valuable 
information  to  help  you  track  down  and  correct  the  problem. 

O' 

So  exceptions  are  there  to  help  me,  not  just  cause  a 
pain  in  my  butt? 

Yes!  Exceptions  are  all  about  helping  you  expect  the 
unexpected.  A  lot  of  people  get  frustrated  when  they  see  code 
throw  an  exception.  But  if  you  think  about  an  exception  as 
NET'S  way  of  helping  you  track  down  and  debug  your  program,  it 
really  helps  out  when  you're  trying  to  track  down  what's  causing 
the  code  to  bomb  out. 


exception  handling 


Oj 

So  when  my  code  throws  an  exception,  it's  not 
necessarily  because  I  did  something  wrong? 

Exactly.  Sometimes  your  data’s  different  than  you 
expected  it  to  be — like  you've  got  a  method  that’s  dealing  with 
an  array  that’s  a  lot  longer  or  shorter  than  you  anticipated  when 
you  first  wrote  it.  And  don't  forget  that  human  beings  are  using 
your  program,  and  they  almost  always  act  in  an  unpredictable 
way.  Exceptions  are  NET'S  way  to  help  you  handle  those 
unexpected  situations  so  that  your  code  still  runs  smoothly  and 
doesn't  simply  crash  or  give  a  cryptic,  useless  error  message. 

Oj  Once  I  knew  what  I  was  looking  for,  it  was  pretty  clear 
that  the  code  on  the  previous  page  was  going  to  crash.  Are 
all  exceptions  easy  to  spot? 

No.  Unfortunately,  there  are  times  when  your  code  will 
have  problems,  and  it'll  be  really  hard  to  figure  out  what’s 
causing  them  just  by  looking  at  it.  That's  why  the  IDE  gives  you 
a  really  useful  tool  called  the  debugger,  It  lets  you  pause  your 
program  and  execute  it  statement  by  statement,  inspecting  the 
value  of  each  individual  variable  and  field  as  you  go  That  makes 
it  a  lot  easier  for  you  to  figure  out  where  your  code  is  acting  in 
a  way  that's  different  from  how  you  expect  it  to  act.  That’s  when 
you  have  the  best  chance  of  finding  and  fixing  the  exceptions— 
or.  even  better,  preventing  them  in  the  first  place 


Exceptions  are  all  about 
helping  you  find  and  iix 
situations  where  your 
code  behaves  in  ways 
you  didn’t  expect. 
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nobody  expects  the ... 


Brian's  code  did  something  unexpected 


When  Brian  wrote  his  excuse  manager,  he  never  expected 
the  user  to  try  to  pull  a  random  excuse  out  of  an  empty 
directory. 


The  problem  happened  when  Brian  pointed  Iris  Excuse  Manager  program  at  an 
empty  folder  on  his  laptop  and  clicked  the  Random  button.  Let’s  take  a  look  at 
it  and  see  if  we  can  figure  out  what  went  wrong.  Here’s  the  unhandled  exception 
window  that  popped  up  when  he  ran  the  program  outside  the  IDE: 


Excuse  Manager 


Unhandled  exception  has  occurred  in  your  application  If  you  click 
Continue,  the  application  wi#  ignore  this  error  and  attempt  to  conhnue  II 
you  click  Quit,  the  application  wi*  dose  immediately 


Index  was  outside  the  bounds  of  the  array 


[  -  Details 


Continue 


Quit 


Okay;  that’s  a  good  starting  point.  It's  telling  us  that  the  index  was  outside  the 
bounds  of  the  array,  right?  So  let's  look  for  an  array  in  the  code  for  the  Random 
Excuse  button’s  event  handler: 


private  void  RandomExcuseButton_Click (object  sender,  EventArgs  e)  { 
if  (CheckChangedO  ==  true)  { 

CurrentExcuse  =  new  Excuse (random.  Folder); 

UpdateForm( false) ; 

1 

1 


Hmm,  no  arrays  in  there.  But  it  creates  a  new  Excuse  object  using  one  of  the 
overloaded  constructors.  Maybe  there’s  an  array  in  the  constructor  code: 


public  Excuse (Random  random,  string  Folder)  ( 

string!]  fileNames  =  Directory .GetFiles (Folder,  "‘.excuse"); 
OpenFile (fileNames [random. Next (fileNames . Length) ] ) ; 


1 


Bin^o!  There’s  the  array 
We  must  be  trying  to  use 
an  mde*  that  s  past  the 
end  of  the  array 
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It  turns  out  that  Directory .  Get  Files  ( )  returns  an  empty  array  when  you 
point  it  at  a  directory  with  no  files  in  it.  Hey,  we  can  test  for  that!  All  we  need 
to  do  is  add  a  check  t<  >  make  sure  the  directory’s  not  empty  before  we 
o|x*n  a  file,  and  the  nasty  unhandled  exception  window  w  ill  be  replaced  with  an 
informative  messagebox. 


private  void  RandomExcuseButtonClick (object  sender,  EventArgs  e)  { 
string!]  fileNames  =  Directory .GetFiles (Folder,  ** .excuse") ; 
if  (fileNames. Length  ==  0)  ( 

MessageBox. Show ("Please  specify  a  folder  with  excuse  files  in 
"No  excuse  files  found") ; 

)  else  { 

if  (CheckChanged ( )  ==  true)  { 

CurrentExcuse  =  new  Excuse (random,  Folder) 

UpdateForm (false) ; 


it", 


) 


By  checkmg  -for  e*Cu$c 
'V  yfiles  i 


) 


in  the  ■folder  before 
we  create  the  £*Cuse 
object,  we  caB  preveBt 
the  e*CeptioB  from  being 
throwB — aBd  poy  >»y  a 
helpful  message  bon,  too 


O 


¥  • 


Oh,  I  get  it.  Exceptions  aren't  always  bad. 
Sometimes  they  identify  bugs,  but  a  lot  of  the  time 
they're  just  telling  me  that  something  happened 
that  was  different  from  what  I  expected. 


That’s  right.  Exceptions  are  a  really  useful  tool 
that  you  can  use  to  find  places  where  your  code 
acts  in  ways  you  don’t  expect. 

A  lot  of  programmers  get  frustrated  the  first  lime  they  see  an 
exception.  But  exceptions  are  really  useful,  and  you  can  use  them  to 
your  advantage.  When  you  see  an  exception,  it’s  giving  you  a  lot  of 
clues  to  help  you  figure  out  when  your  code  is  reacting  to  a  situation 
dial  you  didn’t  anticipate.  And  that’s  good  for  you:  it  lets  you  know 
about  a  new  scenario  that  your  program  has  to  handle,  and  it  gives 
you  an  opportunity  to  do  something  about  it. 
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the  exception  family  tree 


All  exception  objects  inherit  from  Exception 

.NET  has  lots  of  different  exceptions  it  may  need  to  report.  Since  many  of  these 
have  a  lot  of  similar  features,  inheritance  comes  into  play.  .NET  defines  a  base 
class,  called  Exception,  that  all  specific  exceptions  types  inherit  from. 

The  Exception  class  has  a  couple  of  useful  members.  The  Message  properties 
stores  an  easy-to-read  message  about  what  went  wrong.  And  StackTrace  tells 
you  what  was  going  on  in  memory  when  the  exception  occurred,  and  what  led  tip 
to  the  exception.  (There  are  others,  too,  but  we’ll  use  those  first.) 
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The  debugger  helps  you  track  down  and 
prevent  exceptions  in  your  code 

Before  you  can  add  exception  handling  to  your  program,  you  need  to  know 
which  statements  in  your  program  are  throwing  the  exception.  That’s  where 
the  debugger  that’s  built  into  the  IDE  can  he  really  helpful.  When  you  run 
the  debugger,  the  IDE  pops  up  a  toolbar  with  some  really  useful  buttons. 
Take  a  minute  and  hover  your  mouse  cursor  over  each  of  them  to  see  its 
name  and  shortcut  key.  (Those  shortcut  keys  come  in  really  handy.) 


The  Debug  -toolbar  only  shows 
up  when  youVe  debugging  your 
program  in  the  IDE-  So  you'll  have 
to  run  a  program  in  order  to  hover 
over  the  toolbar  icons. 


Stop:  end  the  program  and 
exit  the  debugger. 

Continue:  run  until  the 
next  breakpoint  is  hit 
or  the  program  ends. 


Break  all:  break  the  program 
immediately  and  jump  to  the 
statement  being  executed. 


Show  next  statement:  scroll 
to  the  next  statement  that’s 
going  to  be  executed. 


Restart:  stop 
execution  and  start 
the  program  again. 


Step  over:  execute  the  next 
statement.  If  it’s  a  method, 
execute  it  as  a  single  statement. 


Step  out:  run  the  rest  of  the 
statements  in  the  current  method, 
and  break  when  it’s  done. 


Step  into:  execute  the  next 
statement.  If  it’s  a  method, 
execute  the  first  statement  in 
the  method. 


debugging  means  running  your  code  line  by  line 
to  see  what  happens 

Whenever  you  run  your  program  inside  the  IDE,  you  can  always  pause  it  at  any 
time  by  hitting  the  Break  All  button  in  the  toolbar  (or  choosing  the  command 
from  the  Debug  menu).  This  causes  your  program  to  stop  in  its  tracks  and  show 
you  the  line  of  code  that  it’s  about  to  run.  It  turns  that  line  of  code  yellow  to  show 
you  that  it’s  the  one  that’ll  run  next.  If  you  press  Continue,  then  your  program 
will  keep  running  as  if  you’d  never  stopped  it.  But  you  can  also  step  through  your 
code,  which  means  executing  the  current  line  and  going  to  the  next  one.  If  the  next 
line  is  a  method,  then  you  can  step  into  the  method,  which  causes  the  debugger 
to  jump  to  the  first  line  of  the  method  and  highlight  it.  Or  you  can  step  over  the 
method,  which  executes  the  whole  thing.  If  you’re  inside  a  method,  you  can  step 
out  of  it,  which  causes  the  debugger  to  execute  the  rest  of  the  statements  in  the 
method  and  break  at  the  first  line  after  it  returns  from  the  method. 

You  can  also  inspect  and  change  variables  and  fields  in  your  code  using  the  Watch 
window.  Just  right-click  on  a  variable  in  the  code  and  select  “Add  Watch  ",  and  it’ll 
appear  in  the  Watch  window  or  you  can  type  it  directly  into  the  Watch  w  indow. 
Then  its  value  will  be  displayed.  If  it’s  an  object,  you  can  drill  down  into  its  fields. 


I  Name 

Value 

Type 

•  fileNames.Length 

0 

nt 

When  you  break 
inside  the  debugger, 
the  IDE  stops 
your  program  and 
displays  the  next 
line  ol  code  that 
it’s  about  to  run 
highlighted  in 
yellow.  Then  you 
can  move  forward 
line  by  line  until  you 
find  your  problem. 
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you  don’t  know  where  that  watch  has  been 


Use  the  IPE's  debugger  to  ferret  out  exactly 
what  went  wrong  in  the  excuse  manager 

Let’s  use  tlie  debugger  to  take  a  closer  look  at  the  problem  that  we  ran 
into  in  the  excuse  manager.  It’s  a  good  place  to  get  some  practice  with 
the  debugger,  because  you  know  exactly  what  you're  looking  for.  (That’s  a 
luxury  that  you  don’t  have  most  of  the  time!) 


-^r  * 

-Debug  tliis  -tfr 


Use  a  breakpoint  to  break— or  pause— your  program 

You’ve  got  a  starting  point  the  exception  happens  when  the  Random  Excuse  button 
is  clicked  after  an  empty  folder  is  selected.  So  open  up  the  code  for  the  button,  click 
anywhere  in  the  fust  line  of  the  method,  and  select  “Toggle  Breakpoint”  from  the 
Debug  menu  (or  press  F9):  Die  debugger  shows  your 

breakpoints  as  red  lines  with  a  big 
red  dot  in  the  left-hand  margin 


□  private  void  RandomExcuseButton_Click {object  sender,  EventArgs  e)  } 


ptcingd  fileNames  =  Directory. GetFiles (Folder,  ” ♦.excuse")  ;j 


if  (fileNane3 .Length  ==  0)  l 

.  3hov  »  Wanm-langei  0  try  a  folder''vitTT'l 
I  else  (  ^ 

if  (CheckChanged  ( )  true)  (  \ 

CurrentExcuse  •  new  Excuse { aandom ,  Folder). 
UpdateFormt false) ; 

I  ’  Ssr  nVCr  (,eld  w  liable  Jhd  the 
\UC-  will  show  you  its  value. 


se  files  in  it",  "No  excuse  files  found") 

The  yellow  line  with  a  yellow 
^  arrow  in  the  left-hand  margin 
is  the  ne*t  line  the  debugger  will 
e*etute  when  it  runs 


The  IDE  turned  the  line  red  and  put  a  circle  in  the  left-hand  margin.  That’s  the  ^  ^  ^ 

debugger's  way  of  telling  you  that  it  set  a  breakpoint  on  the  line.  Now,  when  _  jpg  ^ 

you  debug  the  program  in  the  IDE,  execution  will  stop  on  that  line.  Give  it  a  ^  j  a  °  urmm3 

try — run  the  program  in  the  IDE  (using  the  same  “Start  Debugging”  command^'  £)ebu  in  "  b  ta  ’ 
you’ve  been  using  all  along).  When  you  reproduce  the  problem,  the  line  should  “  .  .  use  ^°u  re 

turn  yellow,  with  an  arrow  pointing  to  the  code.  Now  your  program’s  temporarily 
paused.  The  “Start  Debugging”  menu  item’s  turned  into  “Continue  Debugging,” 
too.  Click  it — the  program  will  pick  up  exactly  where  it  left  off,  starting  with  the 
line  you  put  the  breakpoint  on. 


Step  through  the  application 

Use  the  Step  Into  command  (using  either  the  toolbar  or  the  FI  1  key)  to  move  through 
the  application  line  by  line.  When  it  gets  to  the  line  that  creates  the  new  Excuse 
object,  it'll  jump  straight  into  the  constructor  that  you  fixed.  Step  past  the  first  line  so  it 
sets  the  fileNames  variable.  Then  hover  over  the  variable  to  see  its  value. 


using  the  debugger  built 
•►ft©  the  IDE 


s**p*t£* 
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Use  the  Watch  window  to  reproduce  the  problem 

One  really  powerful  feature  of  the  debugger  is  the  Watch  window;  which  lets  you  check  the  value  of 
variables  and  fields  in  your  objects.  Hover  your  mouse  cursor  over  the  “Length”  part  of  f  ileNames . 
Length.  Then  select  all  of  f  ileNames  .  Length,  right-click,  and  select  ‘Add  Watch”  from  the 
menu.  It’ll  get  added  to  the  Watch  window  (which  is  in  the  same  pane  as  Output  you  can  bring  it  up 
by  selecting  “Watch”  under  Windows  in  the  Debug  menu).  Then  add  each  piece  of  the  statement:  first 
random. Next  (f  ileNames .  Length) .  It  should  look  something  like  this,  depending  on  how  many  files 
are  in  the  folder  you  pointed  to — in  this  case,  we  had  five,  so  f  ileNames  has  five  elements: 


We'll  use  the  Watch  window 
to  reproduce  the  problem 
that  caused  the  enCeptiorv 
We'll  start  by  adding  the 
fileNames  array 


151 

Narrj^. 

Value 

Type  jL 

I  it  9  fileNames 

{strng[5]> 

strng[]  ^  1 

♦  random.Next(fileNames.Length) 

1 

n,  1 

You  need  to 
break  (pause) 
the  program 
before  you  can 
add  a  watch 


Set  fileNames  equal  to  an  empty  string  array 

Double-click  in  the  empty  space  in  the  Watch  window  underneath  the  two  watch  variables.  You’ll  get  a 
cursor.  Type  this  in:  fileNames  =  new  string  [0] .  Watch  the  top  row  in  the  window  -as  soon 
as  you  hit  enter,  the  value  of  fileNames  will  change  to  { string  [  0  ]  } .  A  re-evaluate  icon  ©  should 
show  up  next  to  the  random .  Next  line — click  on  it  and  its  value  gets  set  to  0.  So  what  happened? 


The  Watch  window  has  another  very  useful  feature  it  lets  you  change  the  value  of  variables  and 
fields  that  it’s  displaying.  And  it  even  lets  you  execute  methods  and  create  new  objects  and 
when  you  do,  it  displays  its  re-evaluate  icon  (©)  that  you  can  click  to  tell  it  to  execute  that  line  again, 
because  sometimes  running  the  same  method  twice  will  generate  different  results  (like  with  Random). 


;li 


We  know  -the  problem 
Happened  with  an  empt' 
fileNames  array,  so  we 
use  the  Watch  window 
to  change  its  value  to  an 
empty  string  array 

O 


\ 

Name 

Value 

Type 

9  fileNames 

{strng[0]> 

ystrng[] 

L  ♦  random. Next(fileNames  Length) 

1 

®  nt 

1  /9  fileNames  =  new  strrig[0] 

(stnnq[0]} 

strinq[] 

1 

tells  the 

Watch 

window  to 


method- 


Reproduce  the  problem  that  threw  Brian's  original  exception 

Here’s  where  debugging  gels  really  interesting.  Add  one  more  line  to  the  debugger  the  statement  that 
actually  threw  the  exception:  fileNames  [random.  Next  (fileNames .  Length)  ] .  As  soon  as  you 
type  it  in,  the  Watch  window  evaluates  it...  and  that  throws  the  exception.  It  tells  you  that  it  found  the 
exception  by  displaying  an  exclamation  point,  and  displays  the  text  of  the  exception  in  the  Value  column. 


This  e*clamation 
point  is  the  Watch 
window's  way  o( 
telling  you  it  fijund 
an  exception 


Name 

Value 

Type 

9  fileNames 

{strng[0]> 

strng[] 

v  random, Next(fileNames.Length) 

1 

(§)  nt 

9  fileNames  =  new  strng[0] 

{strng[0]} 

(D  strng[] 

_ 

O  fileNames[random.Next(fileName 

Cut  of  bounds  array  index 

®  strng 

When  you  get  an  exception,  you  can  go  back  and  reproduce  it  in  the  debugger.  That’s 
another  way  that  more  descriptive  exception  messages  can  help  you  fix  your  code. 


you  are  here  > 
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make  a  break  for  it 


Qj  How  come  Brian’s  unhandled 
exception  window  looked  different  than 
the  one  in  the  IDE? 

Because  when  you  run  a  program 
inside  the  IDE,  you're  running  it  in  the 
debugger,  which  breaks  the  program 
(as  if  you’d  pressed  the  Break  All  button 
or  inserted  a  breakpoint)  as  soon  as  it 
intercepts  an  exception,  and  displays  it  in 
a  useful  window.  That  lets  you  inspect  the 
Exception  object  and  your  program’s  fields 
and  variables  so  you  can  track  down  the 
problem. 

When  Brian  ran  his  program,  he  wasn’t 
running  it  from  inside  the  IDE  He’d 
published  his  program  and  installed  it,  just 
like  you  did  back  in  Chapter  1  with  the 
Contact  List  program.  You  can  run  your 
program  outside  the  IDE  any  time  without 
publishing  it— just  build  your  program,  which 
causes  Visual  Studio  to  create  an  executable 
file.  Just  look  inside  your  project’s  folder  for 
the  bin/  folder— one  of  its  subdirectories 
should  have  the  exe  file  for  your 
application.  If  you  run  that,  any  exceptions 
that  it  throws  will  be  unhandled  and  show  the 
same  window  that  Brian  saw. 

Qj  So  that's  it?  When  an  exception 
happens  outside  the  IDE,  my  program 
just  stops  and  there's  nothing  I  can  do 
about  it? 

Well,  your  program  does  stop  when 
there's  an  unhandled  exception,  But  that 
doesn't  mean  that  all  of  your  exceptions 
have  to  be  unhandled!  We  ll  talk  a  lot  more 
about  how  you  can  handle  exceptions  in  your 
code  There’s  no  reason  your  users  ever 
have  to  see  an  unhandled  exception. 


tlierejOre  no 

Dumb  Questions 


Qj  How  do  I  know  where  to  put  a 
breakpoint? 

That’s  a  really  good  question,  and 
there’s  no  one  right  answer  When  your  code 
throws  an  exception,  it’s  always  a  good 
idea  to  start  with  the  statement  that  threw  it. 
But  usually,  the  problem  actually  happened 
earlier  in  the  program,  and  the  exception 
is  just  fallout  from  it.  For  example,  the 
statement  that  throws  a  divide  by  zero  error 
could  be  dividing  values  that  were  generated 
10  statements  earlier  but  just  haven’t  been 
used  yet.  So  there’s  no  one  good  answer  to 
where  you  should  put  a  breakpoint,  because 
every  situation  is  different  But  as  long  as 
you've  got  a  good  idea  how  your  code  works, 
you  should  be  able  to  figure  out  a  good 
starting  point. 

Qj  Can  I  run  any  method  in  the  Watch 
window? 

Yes  Any  statement  that’s  valid  in 
your  program  will  work  inside  the  Watch 
window,  even  things  that  make  absolutely  no 
sense  to  run  inside  a  Watch  window.  Here's 
an  example  Bring  up  a  program,  start  it 
running,  break  it,  and  then  add  this  to  the 
Watch  window:  System. Threading. 
Thread.  Sleep  (2000) .  (Remember, 
that  method  causes  your  program  to  delay 
for  two  seconds. )There  s  no  reason  you’d 
ever  do  that  in  real  life,  but  it’s  interesting  to 
see  what  happens:  you'll  get  an  hourglass 
for  two  seconds  while  the  method  evaluates. 
Then,  since  Sleep  ( )  has  no  return 
value,  the  Watch  window  will  display  the 
value,  “Expression  has  been 
evaluated  and  has  no 
va  lue"  to  let  you  know  that  it  didn't  return 
anything  But  it  did  evaluate  it.  Not  only  that, 
but  it  displays  IntelliSense  pop-ups  to 


help  you  type  code  into  the  window.  That’s 
useful  because  it'll  tell  you  what  methods  are 
available  to  an  object  when  your  program  is 
running. 

Qj  Wait,  so  isn’t  it  possible  for  me 
to  run  something  in  the  Watch  window 
that’ll  change  the  way  my  program  runs? 

Yes!  Not  permanently,  but  it  can 
definitely  affect  your  program’s  output.  But 
even  better,  just  hovering  over  fields  inside 
the  debugger  can  cause  your  program  to 
change  its  behavior,  because  hovering 
over  a  property  executes  its  get  accessor 
If  you  have  a  property  that’s  got  a  get 
accessor  that  executes  a  method,  then 
hovering  over  that  property  will  cause  that 
method  to  execute  And  if  that  method  sets 
a  value  in  your  program,  then  that  value  will 
stay  set  if  you  run  the  program  again.  And 
that  can  cause  some  pretty  unpredictable 
results  inside  the  debugger.  Programmers 
have  a  name  for  results  that  seem  to  be 
unpredictable  and  random:  they're  called 
heisenbugs  (which  is  a  joke  that  makes 
sense  to  physicists  and  cats  in  boxes). 

When  jou  run  jour 
program  inside  the 
IDE,  an  unhandled 
exception  will 
cause  it  to  break 
as  il  it  had  run 
into  a  breakpoint. 
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Uh-oh— the  code's  still  got  problems... 

Brian  was  happily  using  his  Excuse  Manager,  when  he  remembered 
that  he  had  a  folder  full  of  excuses  that  lie  made  when  he  first  built 
the  program — but  he  forgot  that  he  made  that  folder  before  he 
added  serialization  to  the  program.  Let’s  see  what  happens.... 


You  can  re-create  Brian’s  problem  just  create  your  own  text-based  Excuse  file 
using  Notepad.  The  first  line  should  be  the  description,  the  second  should  be  the 
results,  and  the  third  should  be  the  last  used  date  (“10/4/2007  12:OB:13  PM”). 


Pop  open  die  Excuse  Manager  and  open  up  the  excuse.  It  throws  an  exception! 

But  this  time,  click  on  the  Details  button  so  we  can  take  a  closer  look  at  what  it  says. 
Pay  attention  to  the  call  stack  that’s  what  it's  called  when  a  method  is  called  by 
another  method,  which  is  called  by  another  method,  etc. 


Excuse  Manager 


© 


Unhanded  except! 
Continue,  the 
you  click  Quit,  the 

Index  was  outside  tl 


li  looks  like  there  was 
3  problem  with  the 

Binarypormatter— which 

>*3kes  sense,  because  it 
was  trying  to  deserialise 
a  text  -Pile. 


You  can  learn  a  lot  Prom  the 
call  stack,  which  tells  you 
which  methods  were  running 
You  can  see  that  the  Excuse 
class's  OpenFile  ()  method 
was  being  called  from  its 
Constructor  (* .  ctor  ). 
which  was  called  from  the 
"Random  Excuse”  button's 
click  event  handler 


The  program  threw  a  SerializationException  Can  we 
figure  out  what  line  threw  it  from  the  exception  details? 


************** 


Exception  Text 


ft************* 


System  Runtime  Serialization  SerializationException  End  of  Stream  encountered  before  parsing 
was  completed. 

at  System. Runtime.Serialization. Formatters. Binary._BinaryParser.Run() 

at  System.Runtime.Serialization.  Formatters.  Binary.  ObjectReader.Desenalize(HeaderHa 
ndler  handler,  _BinaryParser  serParser,  Boolean  fCheck,  Boolean  isCrossAppDomain, 
IMethodCallMessage  methodCallMessage) 

at  System  Runtime.Serialization. Formatters  Binary.BinaryFormatter.Deserialize(Stream 
serializationStream,  HeaderHandler  handler.  Boolean  fCheck,  Boolean  isCrossAppDomain, 
IMethodCallMessage  methodCallMessage) 

at  System.Runtime.Serialization. Formatters  Binary.BinaryFormatter.Deserialize( Stream 
serializationStream) 

at  Chapter10.Excuse.OpenFile(String  ExcusePath)  in  C:\Documents  and  Settings\Administrator\ 
^My  DocumentsWisual  Studio  2005\Projects\Chapter10\Chapter10\Excuse.cs:line  40 

atChapter10.Excuse..ctor(Random  random,  String  Folder)  in  C:\Documents  and  Settings! 
rAdministrator\My  DocumentsWisual  Studio  2005\Projects\Chapter10\Chapter10\Excuse.cs:line  30 

,at  Chapter10.Form1.RandomExcuseButton_Click(Object  sender,  EventArgs  e)  in  C:\ 

Documents  and  Settings\Administratof\My  DocumentsWisual  Studio  2005\Projects\Chapter10\ 
Chapter10\Form1.cs:line  146 


So  the  Derails  button  in  the  unhandled  exception  window  tells  you  a  lot  about  what 
caused  this  problem.  Can  you  think  of  anything  you  can  do  about  it? 


you  are  here  > 
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users  are  unpredictable 


Wait  a  second.  Of  course  the  program's 
gonna  crash— I  gave  it  a  bad  file.  Users 
screw  up  all  the  time.  You  can’t  expect  me 
to  do  anything  about  that,  right? 


Actually,  there  is  something  you  can  do  about  it. 

Yes,  it’s  true  that  users  screw  up  all  the  time.  That’s  a  fact  of  life. 
But  that  doesn’t  mean  you  c  an  t  do  anything  about  it.  There’s  a 
name  for  programs  that  deal  with  had  data,  malformed  input,  and 
other  unexpected  situations  gracefully,  they’re  called  robust.  And 
G#  gives  you  some  really  powerful  exception  handling  tools  to 
help  you  make  your  programs  more  robust.  Because  while  you  can't 
control  what  your  users  do,  you  can  make  sure  that  your  program 
doesn’t  crash  when  thev  do  it. 


ro-bust,  adj. 
sturdy  in  construction;  able 
(o  withstand  or  overcome 
adverse  conditions.  After  the 
Tacoma  Narrows  Bridge  disaster, 
the  civil  engineering  team  looked  I 
for  a  more  robust  design  for 
the  badge  that  would  replace  it. 


Watch  it! 


BinaryFormatter  will  throw  an 
exception  if  there’s  anything  at  all 
wrong  with  a  serialized  file. 


It's  easy  to  get  the  Excuse  Manager  to 
throw  a  SerializationException—just 
feed  it  any  file  that’s  not  a  serialized  Excuse  object. 
When  you  try  to  deserialize  an  object  from  a  file. 
BinaryFormatter  expects  the  file  to  contain  a  serialized 
object  that  matches  the  class  that  it’s  trying  to  read.  If 
the  file  contains  anything  else,  anything  at  all.  then  the 
Deserialize ()  method  will  throw  a  SerializationException. 
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Handle  exceptions  with  try  and  catch 

In  C#,  you  can  basically  say,  “Try  ibis  code,  and  if  an  exception 
occurs,  catch  it  with  this  other  bit  of  code.”  The  part  of  code 
you’re  trying  is  the  try  block,  and  the  part  where  you  deal  with 
exceptions  is  called  the  catch  block.  In  the  catch  block,  you  can 
do  thinks  like  print  a  friendly  error  message,  instead  of  letting  your 
program  come  to  a  screeching  halt: 


private  void  RandomExcuseButton_Click (object  sender, 
EventArgs  e)  { 

code  you  added  a  few  pages  ago  goes  here  . . 


This  is  the 
try  block 
You  start 
exception 
handling 
try 


if  (CheckChanged ( )  ==  true)  { 


CurrentExcuse  =  new  Excuse (random.  Folder); 

fU  the  Code  that  mijht  the, 


UpdateForm( false) ; 


/  ’  catch  keyword  weans  that  -the 

y  block  immediately  following  it  Contain 

_ an  exception  handler 

Ccatch 

When  an  exception  / 

is  thrown,  the  MessageBox  .  Show  ( 


J  '^on  i«ide  the  try  block 
n°  happens,  ,{{ll 

^-exactly  as  usual,  and  the 
statements  in  the  catch  block  will 
b-9Td  But  -fa  statement 
m  try  block  throws  an 
e^eption,  the  rest  of  the  try 
block  won  t  get  executed 


program  immediately' 
jumps  to  the  catch 
statement  and 
starts  executing 
the  catch  block 

} 

> 


"Your  excuse  file  was  invalid.", 
"Unable  to  open  a  random  excuse") ; 

k 


This  is  the  simplest  kind  of  exception 
handling:  stop  the  program,  write  out  the 
exception  message,  and  keep  running 


_ 

If  throwing  an  exception  makes  your  code 
automatically  jump  to  the  catch  block,  what  happens 
to  the  objects  and  data  you  were  working  with  before 
the  exception  happened? 


you  are  here  ► 
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risky  business 


What  happens  when  a  method  you  want  to  call  is  risky? 


Users  are  unpredictable.  They  feed  all  sorts  of  weird  data  into  your 
program,  and  click  on  things  in  ways  you  never  expected.  And 
that’s  just  fine,  because  you  can  handle  unexpected  input  with  good 
exception  handling. 


(I)  Let’s  say  your  user  is 
using  your  code,  and 
gives  it  some  input 
that  it  didn’t  expect. 


(2)  That  method  does 
something  risky, 
something  that  might 
not  work  at  runtime. 


Runtime  just  means  “while  your  program  is 
running".  Some  people  refer  to  exceptions  a 
runtime  errors". 


(3)  You  need  to  know  that 
the  method  you’re 
calling  is  risky. 


(5)  You  then  write  code 
that  can  handle  the 
failure  if  it  does 
happen.  You  need  to  be 
prepared,  just  in  case. 


a  class 
you  wrote 


public  void 

Process (Input  i)  { 
if  (i.IsBadO)  ( 
explode ( ) ; 

) 

} 


user 


your  class,  now  with 
exception  handling 
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Qj  So  when  do  I  use  try  and  catch? 

Any  time  you're  writing  risky  code,  or 
code  that  could  throw  an  exception.  The  trick 
is  figuring  out  which  code  is  risky,  and  which 
code  is  safer. 

You've  already  seen  that  code  that  uses 
input  provided  by  a  user  can  be  risky.  Users 
give  you  incorrect  files,  words  instead  of 
numbers,  names  instead  of  dates,  and  they 
pretty  much  click  everywhere  you  could 
possibly  imagine  And  a  good  program 
will  take  all  that  input  and  work  in  a  calm, 
predictable  way.  It  might  not  give  the  users 
a  result  they  can  use,  but  it  will  let  them 
know  that  it  found  the  problem  and  hopefully 
suggest  a  solution. 

o 

How  can  a  program  suggest  a 
solution  to  a  problem  it  doesn’t  even 
know  about  in  advance? 

That's  what  the  catch  block  is  for  A 
catch  block  is  only  executed  when  code 
in  the  try  block  throws  an  exception,  It's 
your  chance  to  make  sure  the  user  knows 
that  something  went  wrong,  and  to  let  the 
user  know  that  it's  a  situation  that  might  be 
corrected. 

If  the  excuse  manager  simply  crashes  when 
there's  bad  input,  that's  not  particularly 
useful  But  if  it  tries  to  read  the  input  and 
displays  garbage  in  the  form,  that  s  also  not 


there, tire  n<? 

Dumb  Questions 


useful— fad,  some  people  might  say  that  it's 
worse.  But  if  you  have  the  program  display 
an  error  message  telling  the  user  that  it 
couldn't  read  the  file,  then  the  user  has  an 
idea  of  what  went  wrong,  and  information 
that  he  can  use  to  fix  the  problem. 

Oj  Is  the  debugger  only  used  to 
troubleshoot  exceptions? 

No.  The  debugger's  actually  a  really 
useful  tool  that  you  can  use  to  examine  any 
code  you’ve  written.  Sometimes  it  s  useful  to 
step  through  your  code  and  check  the  value 
of  certain  fields  and  variables— like  when 
you’ve  got  a  really  complex  method,  and  you 
want  to  make  sure  it  s  working  properly. 

But  as  you  may  have  guessed  from  the 
name  “debugger,”  its  most  common  use  is 
to  track  down  and  remove  bugs  Sometimes 
those  bugs  are  exceptions  that  get  thrown. 
But  a  lot  of  the  time,  you'll  be  using  the 
debugger  to  try  to  find  other  kinds  of 
problems,  like  code  that  gives  a  result  that 
you  don’t  exped, 

o 

vv^.  I’m  not  sure  I  totally  got  the  Watch 
window.  What’s  it  for,  again? 

When  you're  debugging  a  program, 
you  usually  want  to  pay  attention  to  how 
a  few  variables  and  fields  change.  That’s 
where  the  Watch  window  comes  in  If  you 


add  watches  for  a  few  variables,  the  Watch 
window  updates  their  values  every  time  you 
step  into,  out  of  or  over  code  That  lets  you 
monitor  exadly  what  happens  to  them  after 
every  statement,  which  can  be  really  useful 
when  you're  trying  to  track  down  a  problem. 

The  Watch  window  also  lets  you  type  in  any 
statement  you  want,  and  it’ll  evaluate  it.  If 
the  statement  updates  any  of  the  fields  and 
variables  in  your  program,  then  it  does  that, 
too.  That  lets  you  change  values  while  your 
program  is  running,  which  can  be  another 
really  useful  tool  for  reproducing  exceptions 
and  other  bugs.  ^ 

Any  changes  you  make  in  the  Watch 
*mdow  just  atfect  the  data  in  memory, 
and  only  last  as  long  as  the  program 
is  running  Restart  your  program,  and 
values  that  you  changed  will  be  undone 

Tke  catch  block 
is  only  executed 
when  code  in  the 
try  block  throws 
an  exception.  It 
gives  you  a  chance 
to  make  sure 
your  user  has  the 
information  to  fix 


the  problem. 
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go  with  the  flow 


Use  the  debugger  to  follow  the  try/catch  flow 

An  important  part  of  exception  handling  is  that  when  a  statement  in 
your  try  block  throws  an  exception,  the  rest  of  the  code  in  the  block 
gets  short-circuited.  The  program’s  execution  immediately  jumps  to 
the  first  line  in  the  catch  block.  But  don't  take  our  word  for  it... 


Debug  tl 

% 


Make  sure  that  you’ve  incorporated  all  of  the  code  from  this  chapter  into  the  Random 
Excuse  button  in  your  Excuse  Manager.  Place  a  breakpoint  on  the  first  line  in  the  Random 
Excuse  button’s  Click  event  handler.  Then  run  your  program  in  the  IDE.  Click  the  Folder 
button  and  specify  a  folder  with  a  single  excuse  file  in  it  and  make  sure  it’s  a  not  a  valid 
excuse  file  (any  other  sort  of  file  will  cause  it  to  throw  an  exception).  Press  the  Random 
Excuse  button.  The  debugger  should  break  the  program  at  the  breakpoint  you  placed. 
Press  the  “Step  Over”  button  (or  F10)  six  times  to  get  to  die  statement  that  calls  die  Excuse 
constructor.  Here's  what  your  debugger  screen  should  look  like: 


PI  Ate  a  breakpoint 

on  the  -first  line 
of  the  Random 

Exduse  button  . _ 

event  handler. 

Step  over  the 
statements  until 
your  yellow  “ne*t 
statement”  bar 
shows  that  the 
ne*t  statement  to 
jet  executed  will 
t re  ate  the  new 
£*duse  objedt 


private  void  RandomExcuseButton  Click (object  sender,  EventArgs  e)  ( 


stringd  fileNaraes  =  Directory. GetFiles (Folder,  excuse"); 


if  (fileNames .Length  ==  0)  ( 

MessageBox. Show ("Please  specify  a  folder  with  excuse  files  in  it", 
"No  excuse  files  found") ; 

)  else  ( 
try  ( 

if  (CheckChangedQ  )  ( _ _ 

CurrentExcuse  =  new  Excuse (random,  Folder); 

UpdateForm (false) ; 

)  Make  sure  you  use  the  Step  Over  (flO) 

1  dommand  in  the  debujjer  so  it  doesn't 

CatCLssageBox.Show(  ^  ^  ***  ChedkChanjedO  method 

"Your  excuse  file  was  invalid.", 

"Unable  to  open  a  random  excuse") ; 

) 


Use  Step  Into  (Fl  1)  to  step  into  die  new  statement.  The  debugger  will  jump  to  the  Excuse 
constructor,  and  position  its  yellow  “next  statement”  bar  over  the  declaration  line  in  the  code. 
Keep  hitting  Step  Into  (Fl  I)  to  step  into  the  OpenFileO  method.  Watch  what  happens  when 
you  hit  the  Deserialize  ()  line. 


M  soon  as  you 
step  info  -the — ' 
new  statement 
that  dreates  the 
Exduse  objedt,  the 
debujjer  jumps  to 
the  donstrudtor 


public  Excuse (Random  random,  string  folder) 

I 

string!]  fileNames  =  Directory. GetFiles (folder,  "* .excuse") ; 
OpenFile (fileNames (random. Next (fileNames .Length) ]) ; 

J _ _ _ 


dode 
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As  soon  as  the  debugger  executes  the  Deserialize  ( )  statement,  the  exception  is  thrown 
and  the  program  jumps  straight  to  the  first  statement  in  the  catch  block.  It  short-circuited 
right  past  the  call  to  UpdateForm  ( )  and  jumped  straight  to  the  catch  block. 


The  debugger 
'•/ill  highlight  the 
catch  statement 
with  its  yellow 
“next  statement" 
block,  but  it  shows 
the  rest  ot  the 
block  in  grey  to 
show  you  that  it’s 
about  to  execute 
the  whole  thing- 


private  void  RandomExcuseButton  Click (object  sender,  EventArgs  e)  ( 


3 


tringl)  fileNames  =  Directory. GetFiles (Folder,  "’.excuse"), 


if  (fileNames .Length  ==  0)  ( 

MessageBox. Show ("Please  specify  a  folder  with  excuse  files  in  it", 
"No  excuse  files  found”) ; 

)  else  ( 
try  ( 

if  (CheckChanged  ())  ( 

CurrentExcuse  =  new  Excuse (random.  Folder); 

UpdateForm  { false) ; 

) 

) 

catch  | 

K‘  ■  j;e!:-:.Show( 

"Your  excuse  file  was  invalid.", 

"Unable  to  open  a  random  excuse") ; 

I 


Start  the  program  again  by  pressing  the  Continue  button  (or  F5).  It’ll  begin  running  the 
program  again,  starting  with  whatever  s  highlighted  by  the  yellow  “next  statement”  block 
this  case,  the  catch  block. 


Unable  to  open  a  random  excuse  |>< 


in 


Here's  a  career 
-tip:  a  lot  O-f  C# 
programming  job 
interviews  include 
a  question  about 
how  you  deal  with 
exceptions  in  a 
Constructor 


Watch  it! 


Be  careful  with  exceptions  in  a  constructor! 

You've  noticed  by  now  that  a  constructor  doesn't  have  a  return 
value,  not  even  void.  That’s  because  a  constructor  doesn't 
actually  return  anything.  Its  only  purpose  is  to  initialize  an 
object — which  is  a  problem  for  exception  handling  inside  the 
constructor.  When  an  exception  is  thrown  inside  the  constructor,  then  the 
statement  that  tried  to  instantiate  the  class  won’t  end  up  with  an  instance 
of  the  object.  That's  why  you  had  to  move  the  try/catch  block  to  the  button's 
event  handler.  That  way.  if  there's  an  exception  in  the  constructor,  the  code 
won 't  expect  CurrentExcuse  to  contain  a  valid  Excuse  object. 
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clean  up  after  yourself 


If  you  have  code  that  ALWAYS  should 
run.  use  a  finally  block 


W  hen  your  program  throws  an  exception,  a  couple  of  things  can  happen.  If  the  exception 
isn’t  handled,  your  program  w  ill  stop  processing  and  crash.  If  the  exception  is  handled,  your 
code  jumps  to  the  catch  block.  But  what  about  the  rest  of  the  code  in  your  try  block?  What 
if  you  were  closing  a  stream,  or  cleaning  up  important  resources?  That  code  needs  to  run, 
even  if  tut  exception  occurs,  or  you’re  going  to  make  a  mess  of  your  program’s  stale.  That’s 
where  the  finally  block  comes  in  really  handy.  It  comes  after  the  try  and  catch  blocks. 
The  finally  block  always  runs,  whether  or  not  an  exception  was  thrown.  Here’s  how 
you’d  use  it  to  finish  the  event  handling  in  the  Random  Excuse  button: 


private  void  RandomExcuseButton_Click (object  sender,  EventArgs  e)  { 
string!]  fileNames  =  Directory. GetFiles (Folder,  excuse"); 

if  ( fileNames . Length  =  0)  { 

MessageBox. Show ("Please  specify  a  folder  with  excuse  files  in  it", 
"No  excuse  files  found"); 

}  else  { 

try  { 

if  (CheckChanged ()  ==  true)  { 

CurrentExcuse  =  new  Excuse (random,  Folder); 


) 


} 

catch  (Exception)  { 

CurrentExcuse  =  new  Excuse (); 
CurrentExcuse . Description  =  " 
CurrentExcuse .Results  =  ""; 
CurrentExcuse.LastUsed  =  DateTime .Now; 
MessageBox . Show ( 

"Your  excuse  file  was  invalid.", 
"Unable  to  open  a  random  excuse") ; 


l-f  -the  Extuse  tosWtor  throws  an  e^teyhor,  we 
have  nowg^gE  Irnrmwfl  whrtt's 

But  you  do  know  that  no  instance  of  E*tuse 
was  treated  So  the  catch  block  mat**  a  new 
E*tuse  object  and  tlears  out  all  .ts  fields. 


) 


} 

finally  ( 

UpdateForm( false) ; 

)  FT 


The  finally  blodk  makes  sure  that  UpdateForm() 
jets  run  whether  or  not  an  exception  was  thrown  So  ,( 
the  t*tuse  to nsteuttor  successfully  read  an  extuse,  it'll  tall 
UpdateFormO,  but  it'll  also  tall  it  it  the  to  nstruttor 
threw  an  exception  and  tleared  out  the  extuse 


Did  you  notice  how  catch  was  followed  by  (Exception)  ?  When  you  have  a  catch  statement,  you  can 
follow  it  with  a  specific  kind  of  exception  telling  it  what  to  catch.  If  you  specify  (Exception)  or  leave  it  out,  it 
catches  all  exceptions.  But  if  you  only  wanted  to  catch  a  SerializationException,  you  could  specify  that  inside 
the  parentheses  instead.  Or  you  could  use  an  IOException.  which  will  catch  any  file  input  or  output  problem. 
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Update  the  Random  Excuse  button’s  event  handler  with  the  code  on  the  facing  page.  Then 
place  a  breakpoint  on  the  first  line  in  the  method  and  debug  the  program. 


Run  the  program  normally,  and  make  sure  that  the  Random  Excuse  button  works  when  you 
set  the  program's  folder  to  one  with  a  bunch  of  normal  excuse  files  in  it.  The  debugger  should 
break  at  the  breakpoint  you  set: 


Wher, 

■the  "nexi 
statemen-k” 
bar  arid  the 
breakpoint  are 

on  the  same 

li**»  the  IDE 

shows  you  the 
yellow  arrow 
placed  over  the 
big  red  dot  in 
the  margin. 


Rhprivate  void  RandomExcuseButton_Click (object  sendee,  EventArgs  e)  1 

string!]  fileNames  =  Directory .GetFiles (Folder ,  "‘.excuse"); 

if  (fileName3 .Length  ==  0)  { 

MessageBox. Show ("Please  specify  a  folder  with  excuse  files  in  it", 
"No  excuse  files  found") ; 

I  else  ( 
try 
1 

if  (CheckChangedO )  ( 

CurrentExcuse  =  new  Excuse (random,  Folder); 

1 

1 

catch  (Exception)  ( 

CurrentExcuse  =  new  Excuse (); 

CurrentExcuse. Description  = 

CurrentExcuse. Results  = 

CurrentExcuse. LastUsed  =  DateTime .Now; 

MessageBox . Show ( 

"Your  excuse  file  was  invalid.", 

"Unable  to  open  a  random  excuse"); 

I 

finally  { 

UpdateForm ( false) ; 

1 

I 

\\-  I 


Step  through  the  rest  of  the  Random  Excuse  button’s  event  handler  and  make  sure  it  runs  the 
way  you  expect  it  to.  It  should  finish  the  try  block,  skip  over  the  catch  block  (because  no 
exceptions  were  thrown),  and  then  execute  the  finally  block. 


Nowr  set  the  program's  folder  so  that  it's  pointed  to  the  folder  with  one  malformed  excuse  file 
in  it  and  click  the  Random  excuse  button.  It  should  start  executing  the  try  block,  and  then 
jump  to  the  catch  block  when  it  throws  the  exception.  After  it  finishes  all  of  the  statements 
in  the  catch  block,  it'll  execute  the  finally  block. 
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exceptions  lead  to  instability 


there] ore  no 

Dumb  Questions 


•  Back  up  a  second.  So  every  time 
my  program  runs  into  an  exception,  it's 
going  to  stop  whatever  it’s  doing  unless  I 
specifically  write  code  to  catch  it.  How  is 
that  a  good  thing? 

One  of  the  best  things  about 
exceptions  is  that  they  make  it  really  obvious 
when  you  run  into  problems.  Imagine  how 
easy  it  could  be  in  a  complex  application  for 
you  to  lose  track  of  all  of  the  objects  your 
program  was  working  with.  Exceptions  call 
attention  to  your  problems  and  help  you 
root  out  their  causes  so  that  you  always 
know  that  your  program  is  doing  what  it’s 
supposed  to  do 

Any  time  an  exception  occurs  in  your 
program,  something  you  expected  to 
happen  didn’t.  Maybe  an  object  reference 
wasn’t  pointing  where  you  thought  it  was, 
or  it  was  possible  for  a  user  to  supply  a 
value  you  hadn't  considered,  or  a  file  you 
thought  you’d  be  working  with  suddenly  isn't 
available  If  something  like  that  happened 
and  you  didn't  know  it,  it’s  likely  that  the 
output  of  your  program  would  be  wrong,  and 
the  behavior  from  that  point  on  would  be 
pretty  different  than  you  expected  when  you 
wrote  the  program. 

Now  imagine  that  you  had  no  idea  the  error 
had  occurred  and  your  users  started  calling 
you  up  with  incorrect  data  and  telling  you 
that  your  program  was  unstable.  That’s  why 
it’s  a  good  thing  that  exceptions  disrupt 
everything  your  program  is  doing  They  force 
you  to  deal  with  the  problem  while  it  s  easy 
to  find  and  fix. 

Q:  Okay,  so  now  what’s  a  handled 
exception  and  what’s  an  unhandled 
exception? 

Whenever  your  program  throws  an 
exception,  the  runtime  environment  will 


search  through  your  code  looking  for  a  catch 
block  to  that  matches  it.  If  you've  written 
one,  the  catch  block  will  execute  and  do 
whatever  you  specified  for  that  particular 
exception.  Since  you  wrote  a  catch  block  to 
deal  with  that  error  up  front,  that  exception  is 
considered  handled.  If  the  runtime  can’t  find 
a  catch  block  to  match  the  exception,  it  stops 
everything  your  program  is  doing  and  raises 
an  error.  Then,  you'd  call  the  exception 
unhandled 

o 

What  was  that  bit  about  specifying 
a  particular  kind  of  exception  to  catch? 
Why  would  I  ever  want  to  do  that? 

/ \ You  usually  don’t  want  to  catch 
every  kind  of  exception.  In  fact,  you 
should  do  your  best  to  avoid  catching 
Exception,  and  instead  catch  specific 
exceptions.  For  example,  let’s  say  you 
wanted  your  Excuse  class  to  prevent  a 
FileNotFoundException  from 
getting  back  to  the  form— say,  if  you  wanted 
to  make  it  so  that  if  you  tried  to  open  a  file 
that  wasn't  found,  it  would  automatically 
create  a  excuse  file  with  that  filename  and 
give  it  some  default  values  Then  you  could 
add  a  try  block  followed  by  catch 
(FileNotFoundException) . 
Then  if  a  file  isn’t  found,  the  class  can 
handle  it— but  an  IOException  or 
SerializationException  would 
not  get  caught,  and  the  exception  handler 
you  added  to  the  form  would  catch  it.  But 
if  you  do  that,  you  have  to  make  sure  that 
there's  some  method  in  the  call  stack  that 
does  have  a  catch-all  exception  handler, 
otherwise  the  exception  would  be  unhandled 
And  that  would  cause  the  users  to  see  the 
ugly  “unhandled  exception’  crash. 

Oj 

What  happens  when  you  have  a 
catch  that  doesn't  specify  a  particular 
exception? 


A  catch  block  like  that  will  catch  any 
kind  of  exception  the  try  block  can  throw. 

o 

If  a  catch  block  with  no  specified 
exception  will  catch  anything,  why  would 
I  ever  want  to  specify? 

Good  question  Because  certain 
exceptions  might  require  different  actions 
to  keep  your  program  moving.  An  exception 
that  happens  when  you  divide  by  zero  might 
have  a  catch  block  where  you  go  back  and 
set  some  number  values  to  save  some  of 
the  data  you've  been  working  with.  A  null 
reference  exception  might  require  that  you 
create  new  instances  of  an  object  if  you’re 
going  to  recover. 

o 

Does  all  error  handling  happen  in  a 
try/catch/finally  sequence? 

No.  You  can  mix  it  up  a  bit.  You  could 
have  multiple  catch  blocks  if  you  wanted 
to  deal  with  lots  of  different  kinds  of  errors. 
You  could  also  have  no  catch  block  at  all,  It's 
legal  to  have  a  try/finally  block.  That  wouldn't 
handle  any  exceptions,  but  it  would  make 
sure  that  the  code  in  the  finally  block  ran 
even  if  you  got  stopped  half  way  through  the 
try  block.  But  we  ll  talk  a  lot  more  about  that 
in  a  minute... 

An  unhandier! 
exception  means  your 
program  will  run 
unpredict  ahly.  That's 
why  the  program 
stops  whenever  it 
runs  into  one. 
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PooJ  Puzz]e 

Your  job  is  to  take  code  snippets  from 
the  pool  and  place  them  into  the 
blank  lines  in  the  program.  You 
can  use  the  same  snippet  more 
than  once,  and  you  won't  need 
to  use  all  the  snippets.  Your 
goal  is  to  make  the  program 
produce  the  output. 


public  class  Kangaroo  { 

_  fs; 

int  Croc; 
int  Dingo  =0; 

public  int  Wombat (int  Wallaby)  { 


try  { 

if  ( _  >  0)  ( 

=  _ . OpenWrite ("wobbiegong") 


Output:  ►  G'  day  Mate » 

using  System. 10; 

public  static  void  MainO  ( 

Kangaroo  Joey  =  new  Kangaroo  (); 
int  Koala  =  Joey. Wombat ( 

Joey. Wombat (Joey. Wombat (1 ) ) ) ; 

try  { 

Console. WriteLine ( (15  /  Koala) 

+  "  eggs  per  pound") ; 

) 

catch  ( _ )  ( 

Console. WriteLine ("G' Day  Mate ! ") ; 


Croc  =  0; 

)  else  if  ( _  <  0)  { 

Croc  =  3; 

)  else  { 

=  _ .  OpenRead  ( "wobbiegong" ) 

Croc  =  1 ; 

)  > 

catch  (IOException)  { 

Croc  =  -3; 

) 

catch  ( 

Croc  =  4; 

) 

finally  { 

if  ( _  >  2)  { 

Croc  _  Dingo; 


) 


) 


Exception 
^  IOException 
NullPointerException 
DivideByZeroException 
InvalidCastException 
OutOfMemoryException 


Filelnfo 

File 

Directory 

Stream 

FileStream 


Dingo 

Wallaby 

Koala 

Croc 

Platypus 


Note:  each  snippet 
from  the  pool  can  be 
used  more  than  once! 
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one  object’s  trash  is  another's  treasure 

JoeylAfcmbatO  is  called  three 
times,  and  the  third  time  it 

Pool  puz*k  Sojufien  itejs  sr  4  ^ 

public  static  void  MainO  (  DivideByZeroException 

Kangaroo  Joey  =  new  Kangaroo  ( ) ; 

\  int  Koala  =  Joey.  Wombat  (Joey.  Wombat  (Joey.  Wombat  (1) )); 

Console.  WriteLine  ( (15  /  Koala)  +  ”  eggs  per  pound"); 


\2Z 


The  clue  that  this  is  a 
FileStream  is  that  it  has 
an  0penReadO  method  and 
throws  an  IOException 


catch  (DivideByZeroException;  { 

Console.WriteLine("G'Day  Mate!") ; 


This  catch  block  only 
catches  exceptions  where 
the  Code  divides  by  zero 


This  code  opens  a  file  called  “wobfeiegona* 
keers  *  ®P«*»  -the  trrst  time  it's 
S  Later  on,  it  opens  the  -Pile  again, 
but  It  never  closed  the  Pile,  wh.ch  2*ses 
•t  to  throw  an  IOException. 


public  class  Kangaroo  {  ..  l. 

F  the  Code  divides  by  itro 

FileStream  fs; 

int  Croc; 
int  Dingo  =  0; 

public  int  Wombat (int  Wallaby)  ( 

Dingo  +♦; 

try  ( 

if  (Wallaby  >  0)  { 

uobbiegong"  \  fs  =  File.OpenWrite  ("wobbiegong")  ; 

pei^s  Croc  =  0; 

i!e  again  A  }  else  if  (Wallaby  <  0)  { 

hiCh  causes  )  _  _ 

/  Croc  =  3; 

/  )  else  ( 

fs  =  File.OpenRead  ("wobbiegong")  ; 

\  Croc  =  1; 


catch  (IOException)  ( 
Croc  =  -3;  (V 

»  \  ) 

catch  (  i 

Croc  =  4; 

} 

finally  { 

if  (Dingo  >2)  ( 
Croc  -=  Dingo; 


You  already  know  that  you  always  have 
to  close  Piles  when  you're  done  with 
them  IP  you  don'ti  the  Pile  will  be 
locked  open,  and  iP  you  try  to  open  -t 
again  it'll  throw  an  IOException 


return  Croc; 
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Use  the  Exception  object  to  get 
information  about  the  problem 

We’ve  been  saying  all  along  that  .NET  generates  an  Exception  object  when 
an  exception  is  thrown.  Wien  you  write  your  catch  block,  you  have  access  to 
that  object.  Here’s  how  it  works: 


An  object  is  humming  along,  doing  its  thing,  when  it  encounters  some 
something  unexpected  and  throws  an  exception. 


Luckily,  its  try/catch  block  caught  the  exception.  Inside  the  catch 
block,  it  gave  the  Exception  a  name:  ex. 


try  { 


When  you  specify  a  specific  type  of 
exception  in  the  catch  block,  if  you 
provide  a  variable  name  then  your  Code 
Can  use  it  to  access  the  Exception  object 


} 


MessageBox . Show (message ,  "An  error  occurred"); 


The  exception  object  stays  around  until  the  catch  block  is  done. 
Then  the  ex  reference  disappears,  and  it’s  garbage  collected. 
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Use  more  than  one  catch  block  to  handle 
multiple  types  of  exceptions 

Yon  know  that  you  can  catch  a  specific  type  of  exception  . . .  but  what  if  you  write  code 
where  more  than  one  problem  can  occur?  In  these  cases,  you  may  want  to  write  code 
that  handles  each  different  type  of  exception.  That's  where  using  more  than  one  catch 
block  comes  in.  Here's  an  example  from  code  from  the  beehive  nectar  processing  plant. 
You  can  see  how  it  catches  several  kinds  of  exceptions.  In  some  cases  it  uses  properties 
in  the  Exception  object.  It's  pretty  common  to  use  the  Message  property,  which  usually 
contains  a  description  of  the  exception  that  was  thrown. 


Vou  tan  also  tall  the 

exception's  ToStringO 
method  to  get  a  lot  o-C 
the  pertinent  data  into 
your  WlessageBox 


public  void  ProcessNectar (NectarVat  vat.  Bee  worker,  HiveLog  log)  { 
try  { 

NectarUnit [ ]  units  =  worker . EmptyVat (vat ) ; 

for  (int  count  =  0;  count  <  worker . UnitsExpected,  count++)  { 
stream  hiveLogFile  =  log.OpenLogFile ()  ; 


worker . AddLogEntry (hiveLogFile) ; 


}  If  you  won't  use  the  ExCep tion  object, 

I  there's  no  need  to  detlare  it- 

catch  (IndexOutOfRangeException)  { 

vat. Emptied  =  true; 


catch  (IOException  ex)  { 


When  you  have  several  catch  blotks, 

examined  in  order.  |n  this  tode, 
it  thetks  to  see  if  there  was  an  index 
out  of  range-  If  not,  then  it'll  theck  for  a 
file  I/O  exception  The  last  catch  block 
is  a  general  catch-all  exception  that  will 
jet  executed  for  any  exception  that  wasn  t 
already  caught 


worker . AlertQueen ( 


} 


Log  tile  is  corrupted: 

This  catch  block  assigns  the  exception  to  the  variable  ex, 
whith  it  tan  use  to  get  information  from  the  Exception  object- 


It's  fine  for  two 
blocks  to  use  the 

/U 

S3m€  name  t  e*  / 
for  the  Exception 

} 


us 

catch  (Exception  ex)  { 

worker . AlertQueen ("An  unspecified  error  happened: 
+  "Message:  "  +  ex. Message  +  "\r\n" 

+  "Stack  trace:  "  +  ex . StackTrace  +  "\r\n" 

+  "Data:  "  +  ex. Data  +  "\r\n")  ; 


finally  { 

vat . Seal ( ) ; 

worker . FinishedJob ( ) 


i  .  ,  . r^'T'^vics  m  xne  exception 

object  Message,  wh.ch  has  the  message  you'd  normally 
see  ,n  the  exception  window  in  the  IDE  (“Attempted 

to  divide  bv  >  StackTrace,  which  gives  you  a 
summary  °tthe  call  Stack,  and  Data,  which  somd*;, 
contains  pertinent  data  that's  associated  with  the 
exception 


^mes 
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One  class  throws  an  exception,  wTTj 

another  class  catches  the  exception 

W  hen  you’re  building  a  class,  you  don’t  always  know  how  it’s  going  to  be  used.  Sometimes 
other  people  will  end  up  using  your  objects  in  a  way  that  causes  problems  and  sometimes 
you  do  it  yourself!  That’s  where  exceptions  come  in. 


The  whole  point  behind  throwing  an  exception  is  to  see  what  might  go  wrong,  so  you  can 
put  in  place  some  sort  of  contingency  plan.  You  don’t  usually  see  a  method  that  throws 
an  exception  and  then  catches  it.  An  exception  is  usually  thrown  in  one  method  and  then 
caught  in  a  totally  different  one — usually  in  a  different  object.  __  _ 

Instead  of  this...  it*  tU  f 

to  t  t  •  i  it-  +,ler^me  +<*•  a  profile  data  file  thaf  i+'l 

Without  good  except, on  handtag.  one  excepnon  can  .  ^  u!,  BleOpenO-  |(  tW.  a 

l,nU  the  entire  program.  Hem  s  how  „  would  wo*  m  [  ^  ^ 

stream  =  File. Open (profile) ; 


a  program  that  manages  bee  profiles  for  a  queen  bee. 


profile  Pprof.dat' 


BeePi'of  ile  object  tried 
t>  read  a  file  but  it  wasn't 
Object  so  File  0penO  threw 

an  exception.  The  hive  didn't 
catch  it,  so  it  went  unhand  led 


uoabte  to  find  tfre  specified  He. 


...we  can  do  this. 

The  BeeProfile  object  can  intercept  the  exception  and 
add  a  log  entry.  Then  it  can  turn  around  and  throw 
the  exception  back  to  the  hive,  which  catches  it  and 
recovers  gracefully. 


"-Lg  ^cytion,  logs  ,t  using  its 
W'r.teLogEntryO  method,  and  then  throws 
*  aga in  so  .ts  passed  along  to  the  hive. 


try  { 

stream  =  File. Open (prof ile) ; 

)  catch  (FileNotFoundException  ex)  { 
WriteLogEntry ("unable  to  open  "  + 
profile  +  +  ex. Message () ? 

throw  ex; 


) 


prof  =  new  BeeProfile ("prof .dat") ; 

)  catch  (FileNotFoundException)  ( 

Hive.RecreateBeeProf ile ("prof .dat") 

) 


Mow  when  the  hive  tries  to  create 
a  new  BeeProfile  object  by  passing 
it  an  invalid  filename,  it  Can  trust 
BeeProfile  ts  log  the  error  and 
then  alert  it  to  the  problem  by 
throwing  an  exception  The  Hive 
can  catch  the  e*cepW  and  take 
some  Corrective  action—  in  this  case, 
recreating  the  bee  profile 


you  are  here  ► 


467 


your  very  own  exception 


Pees  weed  an  OutOfHowey  exception 

Your  classes  can  throw  their  own  exceptions.  For  example,  if  you  get  a  null  parameter  in  a  method 
that  was  expecting  a  value,  it's  pretty  common  to  throw  the  same  exception  a  .NET  method  would: 

throw  new  ArgumentNullException ( ) ; 

But  sometimes  you  want  your  program  to  throw  an  exception  because  of  a  special  condition  that 
could  happen  when  it  runs.  The  bees  we  created  in  the  hive,  for  example,  consume  honey  at  a 
different  rate  depending  on  their  weight.  If  there's  no  honey  left  to  consume,  it  makes  sense  to  have 
the  hive  throw  an  exception.  You  can  create  a  custom  exception  to  deal  with  that  specific  error 
condition  just  by  creating  your  own  class  that  inherits  from  Exception  and  then  throwing  the 
exception  whenev  er  you  encounter  a  specific  error. 

public  class  OutOfHoneyException  :  System. Exception  { 


Exception 

Message 

StackTrace 

Gs?BaseExceptenij 

ToStringQ 


r 

your  Exception 

Message 

StackTrace _ 

GetBaseExcepton. 

ToStnrgO 


public  OutOfHoneyException (string  message)  :  base (message) 


} 


age 

■fo* 


public  class  HoneyDeliverySystem  { 

public  void  FeedHoneyToEggs ( )  \ 
if  (honey Level  =0)  { 


need  to  Create  3  class 
your  exception  and  make  sure 
-that  it  inherits  from  System 
Exception  Notice  how  we're 
overloading  the  Constructor  so  we 
can  pass  an  exception  message 


{  } 


throw  new  OutOfHoneyException ("The  hive  is  out  of  honey."); 


)  else  { 

foreach  (Egg  egg  in  Eggs) 


} 

public  partial  class  Forml  :  Form  { 


{ 


•  If  there's  honey  in  the 
kive,  the  exception  will 
«ver  jet  thrown  and 
this  Code  will  run 


This  throws  a  new 
instance  of  the 
exception  object 


private  void  consumeHoney_Click (object  sender,  EventArgs  e)  { 
HoneyDeliverySystem  delivery  =  new  HoneyDeliverySystem () ; 

try  {  You  can  catch  j  custom 

FeedHoneyToEggs  ( )  exception  by  name  ;us£ 

1  n/  1  y  *** 

wbatever  you 

catch  (OutOfHoneyException  ex)  {  need  to  do  to  handle  it 

MessageBox. Show (ex. Message,  "Warning:  Resetting  Hive") 
Hive .Reset () 

> 


} 


|n  this  Case,  if  the  hive  is  out  of  honey  none 
of  the  bees  can  work,  so  the  simulator  can  t 
Continue  The  only  way  to  keep  the  program 
working  once  the  hive  runs  out  of  honey  is 
to  reset  it,  and  we  can  do  that  by  putting 
the  Code  to  reset  it  in  the  catch  block 


Warning:  Resetting  hive  |XJ 
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public  static  void  MainO  ( 

Console. Write  ("when  it  ") ; 
ExTestDrive. Zero ("yes") ; 
Console. Write ("  it  ”); 
ExTestDrive . Zero ("no") ; 
Console. WriteLine (” . ") ; — 


class  MyException  :  Exception  (  ) 


Exception  Magnets 

Arrange  the  magnets  so  the  application  writes 
the  output  to  the  console. 


output: 

when  it  thaws  it  throws. 


Every  value  type — including  Constants  like 
"yes'  or  Y]  or  true— has  built-in  methods 
So  yes  £*\uals(t)  returns  true  i-f  the 
variable  t  Contains  the  string  "yes” 


if  ( "yes". Equals (t) )  { 
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public  static  void  Main()  ( 

Console. Write ("when  it  ") ; 
ExTestDrive . Zero ("yes") ; 
Console. Write (”  it  ”); 
ExTestDrive . Zero ("no") ; 
Console. WriteLine (" . ") ; — 

) 


Exception  Magnets  Solution 

Arrange  the  magnets  so  the  application  writes  the 
output  to  the  console. 

output: 

_ when  it  thaws  it  throws. 


class  MyException  :  Exception  {  ) 


This  line  de-fines  a 
Custom  exception  tailed 
MyException,  whieh  gets 
eaught  in  a  catch  block  m 
■the  Code 


public  class  ExTestDrive  { 

public  static  void  Zero (string  test)  { 


try  { 


Console . Write ("t") • 

r 


doRisky (test) ; 


Console . Wri te ( ”o" ) ; 


)  catch  (MyException)  { 


Console. Write ("s") ; 


Console . Wri to (a  ) . 


}  finally  { 

1 

} 

|  Console. Write ("w") ;  | 

The  Z-eroO  method  either 
prints  "thaws”  or  "throws**, 
depending  on  whether  it  was 
passed  “yes”  or  something  else 
as  its  test  parameter. 


The  finally  block  makes  sure 
that  the  method  always  prints 
"w”  And  the  V*  is  printed  outside 
the  exception  handler,  so  it 
always  prints,  too 
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BULLET  POINTS 


■  Any  statement  can  throw  an  exception  if  something  fails 
at  runtime. 


■  Use  a  try/catch  block  to  handle  exceptions. 
Unhandled  exceptions  will  cause  your  program  to  stop 
execution  and  pop  up  an  error  window. 

■  Any  exception  in  the  block  of  code  after  the  try 
statement  will  cause  the  program's  execution  to 
immediately  jump  to  the  first  statement  in  the  block  of 
code  after  catch. 


■  The  Exception  object  gives  you  information 
about  the  exception  that  was  caught.  If  you  specify  an 
Exception  variable  in  your  catch  statement,  that 
variable  will  contain  information  about  any  exception 
thrown  in  the  try  block: 

try  ( 

//  statements  that  might 
//  throw  exceptions 
}  catch  (IOException  ex)  { 

//  if  an  exception  is  thrown, 

//  ex  has  information  about  it 

} 


■  There  are  many  different  kinds  of  exception  that 
you  can  catch.  Each  has  its  own  object  that  inherits 
from  Exception.  Try  to  avoid  just  catching 
Exception— catch  specific  exceptions. 


Each  try  can  have  more  than  one  catch: 
try  {  . . .  ) 

catch  (NullReferenceException  ex)  { 

//  these  statements  will  run  if  a 
//  NullReferenceException  is  thrown 

} 

catch  (OverflowException  ex)  {  ...  } 
catch  (Exception  ex)  ( 

//  Any  exception  that  hasn't  been 
//  caught  will  jump  to  this  block 

> 

Your  code  can  throw  an  exception  using  throw: 
throw; 

throw  new  Exception ("Exception  message"); 

You  can  create  a  custom  exception  by  inheriting  from 
the  Exception  base  class 

class  CustomException  ;  Exception; 

Most  of  the  time,  you  only  need  to  throw  exceptions 
that  are  built  into  NET,  like  ArgumentException.  The 
reason  you  use  different  kinds  of  exceptions  is  so 
that  you  can  give  more  information  to  your  users 
Popping  up  a  window  with  the  text  “An  unknown 
error  has  occurred"  is  not  nearly  as  useful  as  an  error 
message  that  says  "The  excuse  folder  is  empty.  Please 
select  a  different  folder  if  you  want  to  read  excuses.” 


Aw  easy  way  to  avoid  a  lot  of  problems: '^Rr"br  ,",h"  d“lr J  « 

,  ,  ,,  |.  ,  ,  a  using  statement,  its  DisposeO  method  is 

using  gives  you  try  and  finally  tor  tree  automatically  called  at  the  end  of  the  block 


You  already  know  that  using  is  an  easy  way  to  make  sure  that 
your  files  always  get  closed.  But  what  you  didn’t  know  that  it’s 
really  just  a  C#  shortcut  lor  try  and  finally! 


YourClass  c  =  new 
YourClass () ; 


try  {  ^eh  y°u  use  a  using 

statement,  youVe 

//  code  /^-taking  advantage  of 

}  finally  {  /  ^  ^  T?**  T* 

V  *ts  DisposeO  method 

is  always  called. 


c. Dispose () 
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Exception  avoidance:  implement 
(disposable  to  do  your  own  clean  up 

Streams  are  great,  because  they  already  have  code  written  to  close 
themselves  when  the  object  is  disposed  of.  But  what  if  you  have  your  own 
custom  object,  and  it  always  needs  to  do  something  when  it's  disposed  of? 
Wouldn't  it  be  great  if  you  could  write  your  own  code  that  got  run  if  your 
object  was  used  in  a  using  statement? 

C#  lets  you  do  just  that  with  the  IDisposable  interface.  Implement 
IDisposable,  and  write  your  clean  up  code  in  the  Dispose  ( ) 
method,  like  this: 


IDisposable  is  a  realty  effective 
'way  to  avoid  common  exceptions 
ahd  problems.  Make  sure  you  use 
us"’*9  statements  any  -time  you're 
working  with  any  class  that 
implements  it 

You  can  only  use  a  class  in  a  "using" 
statement  if  it  implements  IDisposable* 
otherwise,  your  program  won’t  Compile 


class  Nectar  :  IDisposable  { 
private  double  amount; 
private  BeeHive  hive; 
private  Stream  hiveLog; 
public  Nectar (double  amount, 
this. amount  =  amount; 
this. hive  =  hive; 
this. hiveLog  =  hiveLog; 


Your  object  must  implement  /Disposable  if  you  want  to 
use  your  object  within  a  using  statement 


BeeHive  hive.  Stream  hiveLog)  { 


} 


I 


public  void  Dispose!) 

Hive . Add ( amount) ; 

Hive . Wri teHiveLogEntry (hiveLog , 

amount  +  "mg  of  nectar  was  added") 


} 


■‘-'n  The  (Disposable  interface  only  has  one 
C>  member  the  DisposeO  method  Whatever 
\  Y°°  put  in  this  method  will  get  executed 
\  at  the  end  of  the  using  statement- 


This  particular  Code  always  logs  the 
amount  of  nectar  added  It's  important, 
and  must  happen,  so  we  put  it  in  the 
LhsposeO  method 


We  can  use  multiple  using  statements  now.  First,  let’s  use  a  built-in  object 
that  implements  IDisposable,  Stream.  Then,  we’ll  work  with  our 
updated  Nectar  object,  which  also  implements  IDisposable: 


You'll  often 
see  one  using 
statement  inside 
of  another. 


using  (Stream  Log  =  new  File .Write ("log. txt") ) 
using  (Nectar  nect  =  new  Nectar (16.3,  hive,  LoqJJ  { 

Bee .  FlyTo  (flower)  ;  tkt  U, 

Bee .  Harvest  (nect)  „WJ,  c|  ||y  at  ttc 

of  the  outer  using  statement 


Bee . FlyTo (hive) ; 

Then  the  Bee  object  uses  the  nect 


l-  r  J  1  uses  the 

object  which  Will  log  automatically  at 

the  end  of  the  inner  using  statement 
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tiierejare  no 

Dumb  Questions 


•  Can  I  only  use  objects  that 
implement  IDisposable  with  a  using 
statement? 

Yes.  IDisposable  is  tailor-made 
to  work  with  using  statements,  and 
adding  a  using  statement  is  just  like 
creating  a  new  instance  of  a  class,  except 
that  it  always  calls  its  Dispose  ( ) 
method. 

Q I  Can  you  put  any  statement  inside  a 
using  block? 

Definitely.  The  whole  idea  with 
using  is  that  it  helps  you  make  sure  that 
every  object  you  create  with  it  is  disposed 
But  what  you  do  with  those  objects  is 
entirely  up  to  you.  In  fact,  you  can  create  an 
object  with  a  using  statement  and  never 
even  use  it  inside  the  block  But  that  would 
bepretty  useless,  so  we  don't  recommend 
doing  that. 


•  Can  you  call  Dispose  ()  outside 
of  a  using  statement? 

Yes  You  don't  ever  actually  need 
to  use  a  using  statement.  You  can  call 
Dispose  ()  yourself  when  you're  done 
with  the  object.  Or  you  can  do  whatever 
cleanup  is  necessary— like  calling  a  stream’s 
Close  ( )  method  manually  But  if  you  use 
a  using  statement  it’ll  make  your  code 
easier  to  understand  and  prevent  problems 
that  happen  if  you  don’t  dispose  your  objects. 

;  You  mentioned  a  “try/finally”  block. 
Does  that  mean  it’s  okay  to  have  a  try  and 
finally  without  a  catch? 

Yes!  You  can  definitely  have  a  try  block 
without  a  catch,  and  just  a  finally.  It  looks 
like  this: 


try  ( 

DoSomethingRisky () ; 
SomethingElseRisky ( ) ; 

} 

finally  { 

AlwaysExecuteThis ()  ; 

) 

If  SomethingRisky  ( )  throws 
an  exception,  then  the  finally  block  will 
immediately  run. 

Qj  Does  Disposed  only  work  with  files 
and  streams? 

No.  there  are  a  lot  of  classes  that 
implement  IDisposable,  and  when  you’re 
using  one  you  should  always  use  a  using 
statement.  (You’ll  see  some  of  them  in  the 
next  few  chapters.)  And  if  you  write  a  class 
that  has  to  be  disposed  in  a  certain  way, 
then  you  can  implement  IDisposable,  too. 


If  try/catch  is  so  great,  why  doesn’t  the 
IDE  just  put  it  around  everything?  Then  we 
wouldn't  have  to  write  all  these  try/ catch 
blocks  on  our  own,  right? 


You  want  to  know  what  type  of  exception  is 
thrown,  so  you  can  handle  that  exception. 

There's  more  to  exception  handling  than  just  printing  out  a 
generic  error  message.  For  instance,  in  the  excuse  Finder,  if  we 
know  we’ve  got  a  FileNotFoundException,  we  might 
print  an  error  that  suggested  where  the  right  files  should  be 
located.  If  we  have  an  exception  related  to  databases,  we 
might  send  an  email  to  the  database  administrator.  All  that 
depends  on  you  catching  specific  exception  types.  . — 


is  why  there  art  so 
"<ar>y  classes  that  inherit 
•from  Exception,  and  why 
you  may  even  want  to  write 
ir  own  classes  to  inherit 
Exception- 


yourc 

From 


you  are  here  ► 


473 


the  one  that  got  away 


The  worst  catch  block  EVER:  comments 

A  catch  block  will  let  your  program  keep  running  if  you  want.  An 
exception  gets  thrown,  you  catch  the  exception,  and  instead  of 
shutting  down  and  giving  an  error  message,  you  keep  going.  But 
sometimes,  that’s  not  such  a  good  thing. 

Take  a  look  at  the  DivisorCalculator,  which  seems  to  be  acting 
funny  all  the  time.  What’s  going  on? 

public  class  Calculator  { 


public  void  Divide (float  dividend,  float  divisor)  { 
try  { 

this. quotient  =  dividend  /  divisor; 

}  catch  { 


feT' 


Here's  the  problem  I*  divisor 
is  zero,  this  will  Create  a 
D'vde&vZevofcxCeyW 

But  there's  a  catch  block.  So 
*hy  are  we  still  getting  errors? 


//  Note  from  Jim:  we  need  to  figure  out  a  way  to  prevent 


//  people  from  entering  in  zero  in  a  division  problem. 

} 

} 

> 

You  should  handle  your  exceptions,  not  bury  them 

Just  because  you  can  keep  your  program  running  doesn’t  mean 
you’ve  handled  your  exceptions.  In  the  code  above,  the  calculator 
won’t  crash...  at  least,  not  in  the  Divide  ( )  method.  But  svhat  if 
some  other  code  calls  that  method,  and  tries  to  print  the  results? 

If  the  divisor  was  zero,  then  the  method  probably  returned  an 
incorrect  (and  unexpected)  value. 

Instead  of  just  adding  a  comment,  and  burying  the  exception, 
you  need  to  handle  the  exception.  And  if  you’re  not  able  to 
handle  the  problem,  don’t  leave  empty  or  commented  catch 
blocks!  T  hat  just  makes  it  harder  for  someone  else  to  track  down 
what’s  going  on.  It’s  better  to  let  the  program  continue  to  throw 
exceptions,  because  then  it’s  easy  to  figure  out  what’s  going  w  rong. 


* 

\  The  programmer  thought  that  he 
N-  Could  bgry  his  exceptions  by  using 
tatch  block,  but  he  just 
caused  a  headache  -for  whoever 
bad  to  track  down  problems  with 
it  later. 


474  Chapter  10 


exception  handling 


Temporary  solutions  are  okay  (temporarily) 

Sometimes  you  lind  a  problem,  and  know  it’s  a  problem,  but  aren’t 
sure  what  to  do  about  it.  In  these  cases,  you  might  want  to  log  the 
problem,  and  note  what’s  going  on.  That’s  not  as  good  as  handling 
the  exception,  but  it's  better  than  doing  nothing. 

Here's  a  temporary  solution  to  the  calculator: 

public  class  Calculator  { 


public  void  Divide (float  dividend,  float  divisor)  { 
try  { 

this .quotient  =  dividend  /  divisor; 

}  catch  (Exception  ex)  { 

StreamWriter  sw  =  new  StreamWriter (@"C : \Logs\errors . txt") ; 
sw. WriteLine (ex. getMessage () ) ; 
sw . Close ( ) ; 

> 

si 


} 


This  still  n«ds  to  be  Wd,  but 

short-term,  this  makes  it  dear 

*here  the  problem  otturred 


I  get  it.  It’s  sort  of  like  using 
exception  handling  to  place  a 
marker  in  the  problem  area. 


Handling  exceptions  doesn’t  always  mean 
the  same  thing  as  FIXING  exceptions. 

It’s  never  good  to  have  your  program  bomb  out.  But  it’s 
way  worse  to  have  no  idea  why  it’s  crashing  or  what  it's 
doing  to  users’  data.  That’s  why  you  need  to  be  sure  that 
you’re  always  dealing  with  the  errors  you  can  predict  and 
logging  the  ones  you  ran't. 
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some  quick  suggestions 


A  few  simple  ideas  for  exception  handling 


TtesTqiM  yew  cope  -fo  MaNPU  fafLvues  (JKACEFULLY. 


(S?ve  yew  usens  USEFUL  0**0*  Htssaqes. 


D. . 

W  Thuow  gvfLf— Tn  .MET  £Yc£Hions  you  <m  Only  fn*ow 

:  ctsfoH  dw^oHS,  if  y ou  nzcv  -to  (?iv£  custon  iNftonna-f  Ton. 


TmInW  aeou-f  eop£  in  yew  My  8Loek  toaf  COULP  qt\ 
SHo*f-C|HeuftoP. 


...  and  most  of  all  ... 


★  ^ 

Avctfp  ONN^ssa^y  ftl£  systoM  ^tos«.  ALWAYS  USE 


USING 


# 


6I.OCK  ANY  HME  YOU  USE  A  STTJEAMJ 


4- 
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Use  what  you  know  about  try/catch/finally  to  improve  the  exception  handling  in 
Brian's  excuse  manager. 


Add  exception  handling  to  the  Open  button’s  Click  event  handler.  Just  make  a  simple 
try/catch  block  dial  pops  up  a  message  box.  Here's  what  it  should  pop  up  if  you  try  to 
open  up  a  file  that’s  not  a  real  excuse  file: 


W  v'  .  Vrc  V  ‘  b'»'  «  “II 

box  should  work  o.^hfu  ^y 


You’re  not  done  yet.  Open  up  the  excuse  manager,  select  a  folder,  enter  data  into  the 
"Description”  and  "Last  Results”  boxes,  but  don’t  enter  a  Last  Used  date.  Now  select 
a  folder  and  try  saving  the  excuse.  Did  you  get  this  ArgumentOutOf  Range  exception? 


Use  the  debugger  to  track  down  the  exception.  This  particular  exception  is  totally 
avoidable — you  can  fix  the  program  and  make  sun-  that  the  exception  never  happens? 
(Hint:  This  has  twilling  to  do  with  adding  a  try  /catch  block.  lou'H  need  to  figure  out  why  the 
“Last  Used"  date  is  causing  a  problem.  Look  carefully  at  the  exception  message  for  clues.) 


One  last  thing.  Before  the  program  threw  the  ArgumentOutOf  Range  exception,  it  saved  out 
a  file.  Load  that  file  in — you  should  get  the  same  exception.  .And  you'll  get  a  different  exception 
if  you  try  to  open  a  file  that’s  not  a  valid  excuse  file.  Add  an  exception  handling  block  nested 
inside  the  one  you  added  in  step  2  to  make  sure  it  doesn't  fail  when  you  try  to  load  an 
invalid  excuse  file  (which  can  happen  in  several  situations).  Here’s  what  to  do: 

1 .  Declare  a  boolean  variable  called  clearForm  above  the  try/catch  block.  You'll  set  this 
to  true  if  there’s  an  exception,  and  check  it  later  to  see  if  the  form  should  be  cleared. 

2.  Add  another  try/catch  block  inside  the  one  you  just  added  to  the  Open  button. 

3.  Add  a  finally  block  to  the  outer  try/catch  to  reset  the  form  to  its  original  empty 
state.  Reset  LastUsed.  Value  to  DateTime  .Now (which  returns  the  current  date)  if 
the  clearForm  variable  is  set  to  true. 
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exercise  solution 


Exercise 

SotvtiOH 


Use  what  you  know  about  try/catch/finally  to  improve  the  exception  handling  to 
Brian’s  excuse  manager. 


private  void  open_Click (object  sender,  EventArgs  e)  { 
if  (CheckChangedO )  { 

openFileDialogl . InitialDirectory  =  selectedFolder; 
openFileDialogl .Filter  = 

"Excuse  files  (* .excuse) | *. excuse) All  files  (*.*)!*•*"; 
openFileDialogl .FileName  =  description. Text  +  ".excuse"; 

DialogResult  result  =  openFileDialogl . ShowDialog () ; 

if  (result  ==  DialogResult. OK)  {  -  Herts  the  try/catch  block  to  Create  a  Pop  up 

bool  clear  Form  =  false;  J  «•  en 

the  Excuse  Constructor  to  load  an  excuse 


try  ( 

currentExcuse  =  new  Excuse (openFileDialogl .FileName) ; 
try  ( 

UpdateForm (false) ; 


} 


TV'L*  f? 'iets  lM<w  M 

(L  (V  F  kit*  the  S,’*C  *  PwW»S 

catch  (  +rom  the  Excuse  Constructor  3 

MessageBox. Show ("The  excuse  file 

+  openFileDialogl . FileName  +  is  invalid", 

"Unable  to  open  the  excuse") ; 
clearForm  =  true; 

}  Here’s  the  messaybox  from  the  outer  try/ 

)  l^~  catcb  block  It  prints  the  exception  message 

catch  (Exception  ex)  { 

MessageBox. Show ("An  error  occurred  while  opening  the  excuse 
+  openFileDialogl .FileName  +  w,\n"  +  ex. Message, 

"Unable  to  open  the  excuse" 

MessageBoxIcon. Error) ; 


MessageBoxButtons . OK, 


clearForm  =  true; 


) 


finally  { 

if  (clearForm)  ( 

description .Text  = 
results. Text  =  ""; 
lastUsed. Value  =  DateTime . Now; 


.know  finally  blocks  wtll  aUys 


run- 


) 


) 
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Exceptioncross 


Across 


Down 


5.  The  base  class  that  DivideByZeroException  and 
FormatException  inherit  from 

8.  An _ Exception  happens  when  you  try  to  cast  a 

value  to  a  variable  that  can't  hold  it 

1 0  If  the  next  statement  is  a  method .  "Step _ "  tells  the 

debugger  to  execute  all  the  statements  in  the  method  and  break 
immediately  afterwards 

12.  If  you _ your  exceptions,  it  can  make  them  hard  to  track 

down 

13,  This  method  is  always  called  at  the  end  of  a  using  block 

14  The  field  in  the  Exception  object  that  contains  a  string  with  a 
description 

15.  One  try  block  can  have  multiple _ blocks 

17.  The _ block  contains  any  statements  that  absolutely 

must  be  run  after  an  exception  is  handled 

18  An _ Exception  means  you  tried  to  cram  a 

number  that  was  too  big  into  a  variable  that  couldn't  hold  it 


1 .  The  window  in  the  IDE  that  you  can  use  to  check  your 
variables'  values 

2.  You'll  get  an  exception  if  you  try  to  divide  by  this 

3.  Toggle  this  if  you  want  the  debugger  to  stop  execution  when  it 
hits  a  specific  line  of  code 

4.  'Step _ *  tells  the  debugger  to  execute  the  rest  of  the 

statements  in  the  current  method  and  then  break 

6.  What  a  reference  contains  if  it  doesn't  point  to  anything 

7.  You  can  only  declare  a  variable  with  a  using  statement  if  it 
implements  this  interface 

9.  When  a  statement  has  a  problem,  it _ an  exception 

11  A  program  that  handles  errors  well 

16.  If  the  next  statement  is  a  method,  "Step _ "  tells  the 

debugger  to  execute  the  first  statement  in  that  method 
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get  it?  finally?  yeah,  we’re  funny 


Exceptioncross  Solution 
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Brian  finally  gets 
his  vacation... 

Now  that  Brian’s  got  a  handle  on  his 
exceptions,  his  job’s  going  smoothly 
and  he  can  take  that  well -deserved 
(and  boss-approved!)  vacation  day. 


...and  things  are  looking  up 
back  home! 


exception  handling 


Your  exception  handling  skills  did  more 
than  just  prevent  problems.  They  ensured 
that  Brian's  boss  has  no  idea  anything 
went  wrong  in  the  first  place! 


Good  exception 
handling  is  invisible 
to  jour  users.  The 
program  never  crashes, 
and  il  there  are 
problems,  they  are 
handled  gracefully, 
without  confusing 
error  messages. 


11  e Vents  nncl  delegates 


What  your  code  does  when 

you’re  not  looking 


Your  objects  are  starting  to  think  for  themselves. 

You  can’t  always  control  what  your  objects  are  doing.  Sometimes  things...  happen.  And 
when  they  do,  you  want  your  objects  to  be  smart  enough  to  respond  to  anything  that 
pops  up.  And  that’s  what  events  are  all  about  One  object  publishes  an  event,  other 
objects  subscibe,  and  everyone  works  together  to  keep  things  moving  Which  is  great, 
until  you’ve  got  too  many  objects  responding  to  the  same  event  And  that’s  when 
callbacks  will  come  in  handy 


this  is  a  new  chapter 
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publisher,  meet  subscriber 


Ever  wish  your  objects  could  think  for  themselves? 


Suppose  you’re  writing  a  baseball  simulator.  You’re  going  to  model  a  game,  sell  the 
software  to  the  Yankees  (they’ve  got  deep  pockets,  right?),  and  make  a  million  bucks. 
You  create  your  Ball,  Pitcher,  Umpire,  and  Fan  objects,  and  a  whole  lot  more. 
You  even  write  code  so  that  the  Pitcher  object  can  catch  a  ball. 


That’s  a  standard  way  of 
naming  methods — we 'll  talk 
more  about  it  later 


Now  you  just  need  to  connect  everything  together.  You  add  an  OnBalllnPlay  ( ) 
method  to  Ball,  and  now  you  want  your  Pitcher  object  to  respond  with  its  event 
handler  method.  Once  the  methods  are  written,  you  just  need  to  tie  the  separate 
methods  together: 


yts  tailed 


'  he  ^  hit  with  a  70  degree 
trajectory  from  homeplate,  and  ifs 
jomg  to  travel  82  -feet 


We  want  the  PiUher  to 
catch  this  ball 


/ 1  ..  .  — ’  nrt»  and 


Pitcher .CatchBall (70,  90) 


Put  how  does  an  object  KNOW  to  respond? 


Here’s  the  problem.  You  really  want  your  Ball  object  to  only  worry  about 
getting  hit.  ruid  your  Pitcher  to  object  only  worry  about  catching  balls 
that  come  its  way.  In  other  words,  you  really  don’t  want  the  Ball  telling  the 
Pitcher,  “I’m  coming  to  you.” 


The  Ball  doesn'-t  know  which 
^•elder  will  pick  H  up...  mayW  ^ 
ritcher,  or  maybe  the  Catcher, 
"^ybe  Third  Baseman  *h0 

deeded  to  ScootlnO. 


This  doesn't  "*an 


that 

h,s  °T"a  .ch  means  that  a  Bah 

interact-  It  V*  ^  fields  it- 


You  want  an 
object  to  worry 
about  it  sell,  not 
other  objects. 
You’re  separating 
the  concerns  ol 
each  object. 
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When  an  EVENT  occurs...  objects  listen 

What  you  need  to  do  when  the  ball  is  hit  is  use  an  event.  An  event  is  simply 
something  that  's  happened  in  your  program.  Then,  other  objects  can 
respond  to  that  event — like  our  Pitcher  object. 

Even  better,  more  than  one  object  can  listen  for  events.  So  the  Pitcher  could 
listen  for  a  ball-being-hit  event,  as  well  as  a  Catcher,  ThirdBaseman,  an 
Umpire,  even  a  Fan.  And  each  object  can  respond  to  the  event  differently 

So  what  we  want  is  a  Ball  object  that  can  raise  an  event.  Then,  we  want  to 
have  other  objects  to  subscribe  to  that  particular  type  of  event...  that 
just  means  listen  to  it,  and  get  notified  when  that  event  occurs. 

A»y  object 

When  a  M  y*s 

BallUP'a'f  event 


event,  noun. 

a  thing  that  happens, 
especially  something  of 
importance.  The  solar 
eclipse  was  an  amazing 

^  o 

event  to  behold. 


Wt  Mr,  substr.be  +hu  r 


:> 


BalllnPlay  event  raised 


o 


K 


Events  look  like  li^htniru) 
bolfs  in  the  IDE  too. 
Vou'll  see  a  an  icon  like 
this  ne*t  to  events  in 
IntelliSense  and  in  the 
properties  window 


Q  D  Q 

ob'^0  "teob'^V  °t>jec*  j 


-o^ 

ob^ 

The  Pitcher  and  other  The  umpire  cheeks  every  ball 
payers  want  to  try  and  to  see  if  it's  fair  or  foul 
field  the  ball.  and  monitor  what  happens 


The  Fan  object 
subscribes  in  case  a  ball 
goes  into  the  seats. 


Want  to  PO  SOMETHING  with  an  event? 
You  need  an  event  handler 


Once  your  object  “hears”  about  an  event,  you  can  set  up  some  code  to  run. 
That  rode  is  called  an  event  handler.  An  event  handler  gets  information 
about  the  event,  and  runs  every  time  that  event  occurs. 

Remember,  all  this  happens  without  your  intervention  at  runtime.  So  you 
write  code  to  raise  an  event,  and  then  you  write  code  to  handle  those  events, 
and  fire  up  your  application.  Then,  whenever  an  event  is  raised,  your  handlers 
kick  into  action...  mthout  you  doing  anything.  And,  best  of  all,  your  objects  have 
separate  concerns.  They’re  worrying  about  themselves,  not  other  objects. 


******* 

Pvevy 

a  W tbom  ** 

raised, 
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if  a  tree  falls  in  the  woods... 


One  object  raises  its  event,  others  listen  for  it... 

Let's  take  a  look  at  how  events,  event  handlers,  and  subscription 
works  in  G#: 


(T)  First,  other  objects  subscribe  to  the  event 

Before  the  Ball  can  raise  its  BalllnPlay  event,  other  objects  need  to 
subscribe  to  it.  That’s  their  way  of  saying,  anytime  a  BalllnPlay  event 
occurs,  wo  want  to  know  about  it. 


Every  object  adds  its  own 
|is”tch  for 

the  event— just  like  you  add — :>■ 

button! _ ClidkO  to  your  A 

programs  to  listen  for  Click  '  BalllnPlay  event 
events. 


r  BalllnPlay  ev< 


,  uent  «*  ra,SCd 


(§)  Something  triggers  an  event 

The  ball  gets  hit.  It's  time  for  the  Ball  object  to  raise  a  new  event. 


o 

°6ject 


rolM  Za  aoes 


Sometimes  we'll  talk 
about  raisin*}  an  event, 
or  -f  iring  it,  or  invoking 
it— they're  all  the  same 
thin^  People  just  use 
different  names  for  it 


(5)  The  ball  raises  an  event 

A  new  event  gets  created  (we'll  talk  about  exactly  how  that  works  in  just  a  minute). 
That  event  also  has  some  arguments,  like  the  velocity  of  the  ball,  as  well  as 
its  trajectory.  Those  arguments  are  attached  to  the  event  as  an  instance  of  an 
EventArgs  object,  and  then  the  event  is  sent  off,  available  to  anyone  listening  for  it. 


Ball/nPlav  is  event  that  gets 
+<red  off  by  by  Ball. 


r 

test**” 
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Then,  the  other  objects  handle  the  event 

Once  an  event  is  raised,  all  the  objects  subscribed  to  that  event  get 
notification,  and  can  do  something: 


(4)  Subscribrs  get  notification 

Since  the  Pitcher,  Umpire,  and  Fan  object  subscribed  to  the  Ball 
object’s  Ball  InPlay  event,  they  all  get  notified — all  of  their  event 
handler  methods  get  called  one  after  another. 


h*  event  handler  is  JUst  the 
"-ethod  in  the  subscriber  object' 
that  gets  run  when  the  event  is 
raised 


As  soon  as  the  ball  raises  its 
event,  it  Creates  a  BallEventAras 
with  the  ball's  trajectory 
and  distance  so  it  can  pass  it  to 
the  subscribers'  event  handlers. 


"on  do? 


Events  are  handled  on  a 
•first  -Come,  f  irst-served 
basis— the  object  that 
subscribes  first  gets 

(s)  Each  object  handles  the  event  ^  notified  first 

Now,  Pitcher,  Umpire,  and  Fan  can  all  handle  the  BalllnPlay  event  in  their 
vn  way.  But  they  don’t  all  run  at  the  same  time — their  event  handlers  get  called 
le  after  another,  with  a  reference  to  a  BallEventArgs  object  as  its  parameter. 


ovv 

one 


IV  V  w 

with.,  notice  that  ,  (o 
the  event  is  nowhere  to 


Ul 


The  Fan  objects  checks 
BallEventArgs  to  see  if 
the  ball  is  close  enough 
to  catch. 


(  ob^c 

The  Umpire  watches.  It  m.ght  even  subscribe  to 
other  events,  like  BallRelded  or  BallThrown, 
to  Further  react  what  happens. 
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i  came  here  for  an  argument 


Connecting  the  dots 


Now  that  you’ve  got  a  handle  on  what’s  going  on, 
let’s  take  a  closer  look  at  how  the  pieces  fit  together 
Luckily,  there  are  only  a  few  moving  parts. 


,  (although  not  rtoyrt&l 

It's  a  good  idea  ^  ^  .  to 


© 


It  means  that  <r  ta» 
uvtast  r*v 
object  m  case  y<* 

n«d  to  «nd  .t  to  arv 
event  that  doesnt 
handle  it  in  pabular 


We  need  an  object  for  the  event  arguments 

Remember,  our  Ball InPlay  event  has  a  few  arguments  that  it 
carries  along.  So  we  need  a  very  simple  object  for  those  arguments. 

.NET  has  a  standard  class  for  it  called  EventArgs.  but  that  class 
has  no  members.  Its  sole  purpose  is  to  allow  your  event  arguments 
object  to  be  passed  to  the  event  handlers  that  use  it.  Here's  the  class 
declaration: 

The  ball  will  use  ■these 
EventArgs  properties  to  pass 

in-formation  hit  to  the 
event  handlers  about 
where  the  ball's  been  hit 


public  class  BallEventArgs 


EventArgs 


BallEventArgs 

Trajectory 

Distance 


2)  Next  we’ll  need  to  define  the  event  in  the  class  that’ll  raise  it 

I  Ik‘  ball  class  will  have  a  line  with  the  event  keyword  this  is  how  it  informs 
other  objects  about  the  event,  so  they  can  subscribe  to  it.  This  line  can  lx* 
anywhere  in  the  class — it’s  usually  near  the  property  declarations.  But  as  long  as 
it’s  in  the  Ball  class,  other  objects  can  subscribe  to  a  ball’s  event.  It  looks  like  this: 


public  event  EventHandler  BalllnPlay; 


Event s  are  usually  public  This 
event  is  def  ined  in  the  Ball 
class,  but  we’ll  want  Pitcher, 
Umpire,  etc  ,  to  be  able  to 
reference  it-  You  Could  make 
rt  private  if  you  only  wanted 
other  instances  of  the  same 
class  to  subscribe  to  it 


After  the  event  keyword  Comes  EventHandler 
That's  not  a  reserved  C#  keyword- it's  defined 
as  part  of  NET.  The  reason  you  need  it  is  to  tell 
the  objects  subscribing  to  the  event  what  their 
event  handler  methods  should  look  like- 


When  you  use  EventHandler,  you're  telling 
other  methods  that  their  event  handlers  need  to 
take  two  parameters,  an  object  named  sender 
and  an  EventArgs  reference  named  e 
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■3)  The  subscribing  classes  need  event  handler  methods 

Every  object  that  has  to  subscribe  to  the  Ball's  BaUInPlay  event  needs  to  have  an  event 
handler.  You  already  know  how  event  handlers  work  every  time  you  added  a  method 
to  handle  a  Button’s  Click  event  or  a  NumericUpDown’s  ValueChanged  event,  the 
IDE  added  an  event  handler  method  to  your  class.  The  Ball's  BaUInPlay  event  is  no 
different,  and  an  event  handler  for  it  should  look  pretty  familiar: 


void  ball  BaUInPlay  (object  sender,  EventArgs  e) 


y  -  v 

There's  C#  rule  that  says  your  event  handlers 
need  to  be  named  a  Certain  wav,  but  there's  a 
pretty  standard  naming  Convention:  the  name  of 
the  object  reference,  followed  by  an  underscore, 
followed  by  the  name  of  the  event- 

t 

The  class  that  has  this  particular  event 
handler  method  has  a  Ball  reference  variable 
called  ball,  so  its  BaUInPlay  event  handler 
starts  wrth  "ball_",  followed  by  the  name 
of  the  event  being  handled,  "BaUInPlay 


The  BaUInPlay  event  declarati  on  listed  its  event 
type  as  EventHandler,  which  means  that  it 
needs  to  take  two  parameters— an  object  called 
sender  and  an  EventArgs  called  e— and  have  no 
return  value 


Each  individual  object  subscribes  to  the  event 

Once  we’ve  got  the  event  handler  set  up.  the  various  Pitcher,  Umpire,  ThirdBaseman,  and  Fan 
objects  need  to  hook  up  their  own  event  handlers.  Each  one  of  them  will  have  its  own  specific 
ball  BalllnPlay  method  that  responds  differently  to  the  event.  So  if  there’s  a  Ball  object 
reference  variable  or  field  called  ball,  then  the  +=  operator  will  hook  up  the  event  handler: 


ball  .BaUInPlay 


This  -tells  C#  to  hook  the  event 
handler  up  to  the  BaUInPlay 
event  of  whatever  object  the  ball 
reference  is  pointing  to. 


new 


EventHandler (ball_Ball InPlay) ; 

_  _  i 


Tie  +—  operator  tells 
2#  subscribe  an  event 
handler  to  an  event 


This  part  specif  ies  which 
event  handler  method  to 
subscribe  to  the  event 

The  event  handler  method  s  signature 

(its  parameters  and  return  value)  has  to 

match  the  one  def  ined  by  EventHandler 
n  .  -l- 


Turn  tlie  pn£e,  there’s  n  little  more..: 
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the  event  of  the  season 


A  Ball  object  raises  its  event  to  notify  subscribers  that  it’s  in  play 

Now  that  the  events  arc  all  set  up,  the  Ball  can  raise  its  event  in  response  to  something  else 
that  happens  in  the  simulator.  Raising  an  event  is  easy — it  just  calls  the  BalllnPlay  event. 


if  (BalllnPlay  !=  null) 
BalllnPlay (this ,  e) ; 


e  15  d  new 


BallEventArgs  object 


Tbe  ball  $ets  bit,  and 
tbe  Ball  object  yes 
into  action 


^  _  ^bt  Jta... 


oX3  y" 


...and 
passing 

it  to  tbe 
^  event  be>n^ 

Z-  x  aised 

Now  tbe 

BalllnPlay  event  ^ is 

active.  wWs 

_  ,  subscribed? 

I  He  pitcher  booked  up  its 

,  event  handler  to  the  ball’s 
(  BalllnPlay  event- 

So  ^  yWed. 
etl.od  1  ^ 


If  you  raise 
an  event  with 
no  handlers, 
it’ll  throw  an 
exception. 


If  no  other  objects  have 
added  their  event  handlers 
to  an  event,  it’ll  be  null.  So 
always  check  to  make  sure 
your  event  handler  isn't 
equal  to  null  before  you  raise 
it.  If  you  don’t,  it’ll  throw  a 
NullReferenceException. 


Use  a  standard  name  when  you  add  a  method  to  raise  an  event 

Take  a  minute  and  go  the  code  for  any  form  and  type  the  keyword  override  any  place  you'd 
declare  a  method.  As  soon  as  you  press  space,  an  IniclliSense  window  pops  up: 

override  Notice  ho*  each  cJc  these  methods 

takes  an  EventAry  as  a  parameter? 
They  all  pass  that  parameter  on  to 
the  event  when  they  raise  it- 


There  are  a  huge  number  of  events  that  a  Form  object  can  raise,  and  every  one  of  them  has 
its  own  method  that  raises  it.  The  form's  OnDoubleClickQ  raises  the  DoubleClick  event,  and 
that’s  the  whole  reason  it’s  there.  So  the  Ball  event  will  follow  the  same  convention:  we'll 
make  sure  it  has  a  method  called  OnBalllnPlay  that  takes  a  BallEventArgs  object  as  a 
parameter.  The  baseb;dl  simulator  will  call  that  method  any  time  it  needs  the  ball  to  raise  its 
BalllnPlay  event  so  when  the  simulator  detects  that  the  bat  hit  the  ball,  it'll  create  a  new 
instance  of  BallEventArgs  with  the  hall’s  trajectory  and  distance  and  pass  it  to  OnBalllnPlavQ. 


r  OnCursorChangedfEventArgs  e) 
f*  OnDeactivatetEventAros  ei 


>♦  OnDoubleOck  (E  ventArgs  e) 

?♦  OnDragDroptpragEventArgs  drgevent) 
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Oj  Why  do  I  need  to  include  the  word 
EventHandler  when  I  declare  an  event?  I 
thought  the  event  handler  was  what  the 
other  objects  used  to  subscribe  to  the 
events. 

That's  true— when  you  need  to 
subscribe  to  an  event,  you  write  a  method 
called  an  event  handler  But  did  you  notice 
how  we  used  EventHandler  in  the 
the  event  declaration  (step  #2)  and  the  in 
line  to  subscribe  the  event  handler  to  it  (step 
#4)?  What  EventHandler  does  is  it 
defines  the  signature  of  the  event— it  tells 
the  objects  subscribing  to  the  event  exactly 
how  they  need  to  define  their  event  handler 
methods.  Specifically,  it  says  that  if  you  want 
to  subscribe  a  method  to  this  event,  it  needs 
to  take  two  parameters  (an  ob  j  ect  and 
an  EventArgs  reference)  and  have  a 
void  return  value. 

Oj  What  happens  if  I  try  to  use  a 
method  that  doesn't  match  the  ones  that 
are  defined  by  EventHandler? 

Then  your  program  won  t  compile. 

The  compiler  will  make  sure  that  you 
don’t  ever  accidentally  subscribe  an 
incompatible  event  handler  method  to  an 
event.  That’s  why  the  standard  event  handler, 
EventHandler,  is  so  useful— as  soon 
as  you  see  it,  you  know  exactly  what  your 
event  handler  method  needs  to  look  like. 

o 

Wait,  “standard"  event  handler? 
There  are  other  kinds  of  event  handlers? 


there. ore  no 

Dumb  Questions 


Yes!  Your  events  don’t  have  to  send 
an  object  and  an  EventArgs.  In  fact,  they 
can  send  anything  at  all— or  nothing  at 
all!  Look  at  the  last  line  in  the  IntelliSense 
window  on  the  bottom  on  the  facing  page. 
Notice  how  the  OnDragDrop  method  takes 
a  DragEventArgs  reference  instead  of  an 
EventArgs  reference?  DragEventArgs 
inherits  from  EventArgs,  just  like 
BallEventArgs  does.  The  form's  DragDrop 
event  doesn't  use  EventHandler  It  uses 
something  else,  DragEventHandler,  and 
if  you  want  to  handle  it  your  event  handler 
method  needs  to  take  an  object  and  a 
DragEventArgs  reference, 

The  parameters  of  the  event  are  defined  by 
something  called  a  delegate— EventHandler 
and  DragEventArgs  are  two  examples  of 
delegates.  But  we  ll  talk  more  about  that  in 
a  minute. 

o 

So  I  can  probably  have  my  event 
handlers  return  something  other  than 
void,  too,  right? 

Well,  you  can,  but  it's  often  a  bad  idea 
if  you  don’t  return  void  from  your  handler, 
you  can't  chain  event  handlers  That  means 
you  can’t  connect  more  than  one  handler 
to  each  event  Since  chaining  is  a  handy 
feature,  you’d  do  best  to  always  return  void 
from  your  event  handlers. 

Oj  Chaining?  What’s  that? 

It's  how  more  than  one  object  can 
subscribe  to  the  same  event— they  chain 
their  event  handlers  onto  the  event,  one  after 


another.  We'll  talk  a  lot  more  about  that  in  a 
minute,  too, 

o* 

is  that  why  I  used  +*  when  when 
I  added  my  event  handler?  Like  I’m 
somehow  adding  a  new  handler  to 
existing  handlers? 

Exactly!  Anytime  you  add  an  event 
handler,  you  want  to  use  +=.  That  way,  your 
handler  doesn't  replace  existing  handlers. 

It  just  becomes  one  in  what  may  be  a  very 
long  chain  of  other  event  handlers,  all  of 
which  are  listening  to  the  same  event. 

Q/  Why  does  the  ball  use  “this”  when 
it  raises  the  BalllnPlay()  event? 

Because  that's  the  first  parameter 
of  the  standard  event  handler  Have  you 
noticed  how  every  Click  event  handler 
method  has  a  parameter  “object  sender"? 
That  parameter  is  a  reference  to  the  object 
that’s  raising  the  event.  So  if  you’re 
handling  a  button  click,  sender  points 
to  the  button  that  was  clicked.  And  if  you’re 
handling  a  BalllnPlay  event,  sender  will 
point  to  the  Ball  object  that’s  in  play— and 
the  ball  sets  that  parameter  to  this  when 
it  raises  the  event. 

A  SINGLE  event  is 

always  raised  I>>  a 

SINGLE  object. 


But  a  SINGLE 

event  can  he 
responded  to  Iry 

MULTIPLE  objects. 
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that’ll  save  you  some  typing 


The  IPE  creates  event  handlers  for  you  automatically 


Most  programmers  follow  the  same  convention  for  naming  their  event  handlers.  If 
there’s  a  Ball  object  that  has  a  BalllnPlay  event,  and  the  name  of  the  reference 
holding  the  object  is  called  ball,  then  the  event  handler  would  typically  be  named 
ballBalllnPlay  ( ) .  That’s  not  a  hard-;md-fast  rule,  but  if  you  write  your  code 
like  that,  it'll  lx*  a  lot  easier  for  other  programmers  to  read. 


Luckily,  the  IDE  makes  it  really  easy  to  name  your  event  handlers  properly.  It  has  a 
feature  that  automatically  adds  event  handler  methods  for  you  when  you’re 
working  with  a  class  that  raises  an  event.  It  shouldn't  lx-  too  surprising  that  the  IDE 
cmi  do  this  for  you  idler  all,  this  is  exactly  what  it  does  when  you  double-click  on  a 
button  in  your  form. 


+  7^ 

Do  this 

Start  a  new  Windows  application  and  add  the  Ball  and  BallEventArgs 

Here's  the  Ball  class: 


public  class  Ball  { 

public  event  EventHandler  BalllnPlay; 
public  void  OnBalllnPlay (BallEventArgs  e)  ( 
if  (BalllnPlay  !=  null) 

BalllnPlay (this,  e) ; 

} 

} 

And  here’s  the  BallEventArgs  class: 

public  class  BallEventArgs  :  EventArgs  { 

public  int  Trajectory  {  get;  private  set;  } 
public  int  Distance  {  get;  private  set;  } 
public  BallEventArgs (int  Trajectory,  int  Distance)  ( 
this . Trajectory  =  Trajectory; 
this . Distance  =  Distance; 

} 

1 


Start  adding  the  Pitcher's  constructor 

Add  a  new  Pitcher  class  to  your  project.  Then  give  it  a  constructor  that  takes  a  Ball  reference 
called  ball  its  a  parameter.  There  will  be  one  line  of  code  in  the  constructor  to  add  its  event 
handler  to  ball .  BalllnPlay.  Start  typing  the  statement,  but  don’t  type  +=  yet. 

public  Pitcher (Ball  ball)  { 
ball . BalllnPlay 

} 
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Type  +=  and  the  IDE  will  finish  the  statement  for  you 

As  soon  as  you  type  +=  in  the  statement,  the  IDE  displays  a  very  useful  little  box: 

public  Pitcher (Ball  ball)  ( 

ball .BalllnPlay  += _ 

}  [new  EventHandler(bdlLBdtllnPlay);  (Press  TAB  to  nsert)| 

As  soon  as  you  press  the  tab  key,  the  IDE  will  finish  the  statement  for  you.  It'll  look  like  this: 

public  Pitcher (Ball  ball)  ( 

ball .BalllnPlay  +=  new  EventHandler (ballBalllnPlay) ; 

) 


ItVken  you  double-click  on  a  button  in  the  •form  designer,  the  IDE  does  the 
eyatt  same  trick— adding  an  event  handler  automatically — except  that  it  adds 
the  Code  to  the  form's  InitializeComponent  ()  method  in  the  Form). 
Des13nee.es  -File  instead  oF  just  addin3  it  to  the  end  oF  the  class  File 


The  IDE  will  add  your  event  handler,  too 

You’re  not  done — you  still  need  to  add  a  method  to  chain  onto  the  event.  Luckily,  the  IDE  takes  care 
of  that  for  you,  loo. 


new  EventHandler ( 


|Press  TAB  to  generate  hander  bal_BallnPlay'  n  thrs  ct- 


Hit  the  tab  key  again  to  make  the  IDE  add  this  event  handler  method  to  your  Pitcher  class.  The 
IDE  will  always  follow  the  objectName  HandlerName  ( )  convention: 


void  ball_BallInPlay (object  sender,  EventArgs  e)  { 

throw  new  NotlmplementedException  ( ) ;  |p£  always  Fills  in  -this 

NotUplementedExcepW)  *  a  placeholder 

so  iF  you  run  the  Code  it'll  throw  an  exception 
that  tells  you  that  you  still  need  ho  implement 
somethin3  it  Filled  in  automatically 

Finish  the  pitcher's  event  handler 

Now  that  you’ve  got  the  event  handler’s  skeleton  added  to  your  class,  fill  in  the  rest  of  its  code.  I  he 
pitcher  should  catch  any  low  balls,  otherwise  he  covers  first  base.  Since  BallEventA^s  is  a  subclass  oF 

void  ball_BallInPlay  (Ball EventArgs  e)  (  s'"  FventA^s,  we  II  downcast  it  usin3  the 

if  (e  is  BallEventArgs)  (  as  keyword  so  we  Can  use  its  properties. 


(e  is  BallEventArgs)  ( 
BallEventArgs  ballEventArgs 
if  ( (ballEventArgs. Distance 
CatchBall ( ) ; 

else 

CoverFirstBase () ; 


=  e  as  BallEventArgs; 

<  95)  &&  (ballEventArgs .Trajectory  <  60)) 

You  II  add  these  methods 
in  a  minute- 
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put  it  all  together 


ExettctSe 


It’s  time  to  put  what  you've  learned  so  far  into  practice.  Your  job  is  to  complete  the  Ball  and 
Pitcher  classes,  add  a  Fan  class,  and  make  sure  they  all  work  together  with  a  very  basic 
version  of  your  baseball  simulator. 


Complete  the  Pitcher  class. 

Below  is  what  we’ve  got  for  Pitcher.  Add  the  CatchBall  ()  and  CoverFirstBase  () 
methods.  Both  should  print  out  that  the  catcher  Inis  either  caught  the  ball,  or  run  to  first  base. 


public  class  Pitcher  ( 

public  Pitcher (Ball  ball)  { 

ball .BalllnPlay  +=  new  EventHandler (ball_BallInPlay) ; 

) 

void  ballBalllnPlay (object  sender,  EventArgs  e)  ( 
if  (e  is  BallEventArgs) ( 

BallEventArgs  ballEventArgs  =  e  as  BallEventArgs; 

if  ( (ballEventArgs. Distance  <  95)  &&  (ballEventArgs .Trajectory  <  60)) 
CatchBall ();  ? 

else  You'll  seed  to  implement  these 

CoverFirstBase  () ;  J  ^  two  methods  to  write  a  line  of 
1  output  to  the  Console 


O 

object 


Write  a  Fan  class. 

Create  another  class  called  Fan.  Fan  should  also  subscribe  to  the  BalllnPlay 
event  in  its  constructor.  The  fan’s  event  handler  should  see  if  the  distance  is 
greater  than  400  feet  and  the  trajectory  is  greater  than  30  (a  home  run),  and 
grab  for  a  glove  to  try  and  catch  the  ball  if  it  is.  If  not,  the  fan  should  scream 
and  yell.  Write  out  what’s  going  on  with  the  fan  to  the  console. 


f 

^  Look  at  the  output  window  on 
the  fating  page  to  see  exactly 
what  it  should  print. 
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Build  a  very  simple  simulator. 

Create  a  new  application.  The  application  should  have  two  NumericUpDown 
controls:  one  for  the  ball’s  distance,  and  one  for  its  trajectory.  Add  a  button, 
labeled  “Pla)7  ball!"  When  “Play  ball!”  is  clicked,  a  ball  is  hit  with  the  values  in 


the  two  NumericUpDowns.  Your  form  should  look  something  like  this: 


The  value  for  trajeitory 
can  range  -from  0  -to 
1 00,  so  set  its  Minimum 
property  to  0,  Maximum 
•bo  loo  and  Value  to  10 


Don't  forget  to  cast  the 
Value  properties  to  ints 
before  you  use  them. 


The  Distance  tan  range 
tro««  0  to  500,  with  a 
default  value  of  100. 


Create  the  following  output. 

See  if  you  can  make  your  simulator  generate  this  output  with  three  successive 
balls  pul  into  play.  Write  down  the  values  you  used  to  get  the  result  below: 


Ball  1: 

Trajectory: 

Distance: 


Ball  2: 

Trajectory': 

Distance: 


Ball  3: 

Trajectory: 

Distance: 


exercise  solution 


&teRa$e 

Solution 


It's  time  to  put  what  you've  learned  so  far  into  practice,  Your  job  is  to  complete  the  Ball  and 
Pitcher  classes,  add  a  Fan  class,  and  make  sure  they  all  work  together  with  a  very  basic 
version  of  your  baseball  simulator. 


public  class  Ball 


public  event  EventHandler  BalllnPlay; 
public  void  OnBalllnPlay (BallEventArgs  e) 


Read-only 
automate  i 

properties  work  1 
really  well  in  event ( 
arguments  because 
the  event  handlers 
only  read  the  data, 
passed  to  them 


if  (BalllnPlay  !  =  null) 
BalllnPlay (this,  e); 


public  class  BallEventArgs  { 


The  0nBall|nlayO  method  just  raises 
the  BalllnPlay  event— but  it  has  to 
Check  make  sure  it's  not  null,  otherw.se 
it  II  throw  an  exception. 


public  int  Trajectory  {  get;  private  set;  } 
public  int  Distance  {  get;  private  set;  } 
public  BallEventArgs (int  Trajectory,  int  Distance) 
f 

this. Trajectory  =  Trajectory; 
this. Distance  =  Distance; 


public  class  Fan  { 

public  Fan (Ball  ball) 


The  Pan  object’s  Constructor 
chains  rts  event  handler  onto  the 
BalllnPlay  event 


ball. BalllnPlay  +=  new  EventHandler (ball_BallInPlay) ; 


void  ball_BallInPlay (object  sender,  EventArgs  e) 

( 

The  fan's  BalllnPlay  if  (e  is  BallEventArgs)  { 

event  handler  looks  BallEventArgs  ballEventArgs  =  e  as  BallEventArgs; 

■for  any  ball  that's  if  (ballEventArgs. Distance  >  400  &&  ballEventArgs .Trajectory  >  30) 

high  and  long  l  Console  .WriteLine  ("Fan :  Home  run!  I'm  going  for  the  ball!"); 

' - ^,1  C-Q 


Console. WriteLine ("Fan:  Woo-hoo!  Yeah!"); 
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public  class  Pitcher  { 

public  Pitcher (Ball  ball)  { 

ball.BalllnPlay  +=  new  EventHandler (ball_BallInPlay) ; 

j  You  already  Wave  -the 

pitcher's  BalllnPlay  event 

void  ball_BallInPlay  (object  sender,  EventArgs  e)  {  (L-  handler  It  looks -for  any 

if  (e  is  BallEventArgs)  (  i  ^j|s 

BallEventArgs  ballEventArgs  =  e  as  BallEventArgs; 

if  ( (ballEventArgs. Distance  <  95)  &&  (ballEventArgs .Trajectory  <  60)) 
CatchBall  () ; 

else 

CoverFirstBase ( ) ; 

) 

) 


private  void  CatchBall ()  ( 

Console. WriteLine ("Pitcher :  I  caught  the  ball") ; 

) 


private  void  CoverFirstBase ( )  { 

Console. WriteLine ("Pitcher ;  I  covered  first  base"); 

) 


public  partial  class  Forml  :  Form  { 

Ball  ball  =  new  Ball  ( ) ; 

Pitcher  pitcher; 

Fan  fan; 


public  Forml ()  ( 

InitializeComponent () ; 
pitcher  =  new  Pitcher (ball) 
fan  =  new  Fan (ball); 

} 


f 


The  to rm  needs  one  ball, 
one  tan,  and  one  pitcher. 

It  hooks  the  tan  and 
pitcher  up  to  the  ball  in 
its  Constructor. 

When  the  button’s  clicked,  the  tom.  tells  the 
pitcher  to  pitch  the  ball  to  the  batter,  which  tells 
the  ball  to  tire  ott  its  BalllnPlay  event,  which  calls 
the  event  handlers  in  the  pitcher  and  tan  objects- 


( 


private  void  playBall_Clic)c (object  sender,  EventArgs  e)  { 
BallEventArgs  ballEventArgs  =  new  BallEventArgs ( 

(int) trajectory .Value,  (int) distance. Value) ; 
ball .OnBalllnPlay (ballEventArgs) ; 

) 


Ball  1: 

Ball  2: 

Ball  3: 

Trajectory: 

75 

Trajectory: 

Trajectory: 

Distance: 

105 

Distance: 

GO 

Distance: 

Here  are  the  values 
**  used  to  get  the 

output  /ours  might 
k  J  tittle  ditterent 


*0. 

Ay?.. 
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introducing  the  events  page 


The  forms  you've  been  building  all  use  events 

Kvery  time  you’ve  created  a  button,  double-clicked  on  it  in  the  designer, 
and  written  code  for  a  method  like  buttonl  Click  ( ) ,  you’ve  been 
working  with  events. 


+d&i  * 


Create  a  new  Windows  Application  project.  Bring  up  the  form,  and  go  to  the  Properties 
window.  There  are  icons  at  the  top  of  die  window  -click  on  the  one  dial’s  got  a  lightning 
bolt  icon  on  it.  That  will  bring  up  the  events  page  in  the  Properties  window: 


Stroll  dovm  { o  Click  and  double- 
dlitk  on  the  'word  'Click  When 
you  do,  the  IDE  will  add  a  new 
elitk  event  handler  to  your  torn, 
that  sets  fired  every  lime  you 
clitk  on  it  And  it’ll  add  a  line 
to  Eorml-Desiyier.es  to  hook  the 
event  handler  uf  to  the  event 


Double-click  on  the  “Click"  row  in  the  events  page.  The  IDE  will  automatically  add  an  event 
handler  method  to  your  form  called  Forml_Click.  Add  this  line  of  code  to  it: 

private  void  Forml_Click (object  sender,  EventArgs  e)  { 

MessageBox. Show ("You  just  on  clicked  the  form"); 

1 

Visual  Studio  did  more  than  just  write  a  little  method  declaration  for  you.  though.  It  also 
hooked  the  event  handler  up  to  the  Form  objects  Click  event.  Open  up  Form  I  .Designer.es  and 
use  the  Quick  F'ind  feature  in  the  IDE  to  search  for  the  text  Forml  Click  in  the  current 
project.  You'll  find  this  line  of  code: 

this. Click  +«  new  System. EventHandler (this . Forml_Click) ; 

Now  run  the  program  and  make  sure  your  code  works! 


Event  handlers  always  need  to  be  “hooked  up”. 

if  you  drag  a  button  onto  your  form  and  add  a  method 
called  buttonl_Cl  ick  ( ) ,  that  has  the  right  parameters, 
but  isn’t  registered  to  listen  to  your  button,  the  method 
won't  ever  get  called.  Double-click  on  the  button  in  the 
designer— the  IDE  will  see  the  default  event  handler  name  is  taken,  so 
it’ll  add  an  event  handler  for  the  button  called  buttonl  Click  1(). 
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One  event,  multiple  handlers 

Here’s  a  really  useful  thing  that  you  can  do  w  ith  events:  you  can  chain  them 
so  that  one  event  or  delegate  calls  many  methods,  one  after  another.  Let’s 
add  a  few  buttons  to  your  application  to  see  how  it  works. 


Add  these  two  methods  to  your  form: 

private  void  SaySomething (object  sender,  EventArgs  e)  ( 
MessageBox. Show ("Something") ; 

} 

private  void  SaySomethingElse (object  sender,  EventArgs  e)  ( 
MessageBox. Show ("Something  else") ; 

) 


Now  add  two  buttons  to  your  form.  Double-click  on  each  button  to  add  its  event  handler. 
Here’s  the  code  for  both  event  handlers: 


private  void  buttonl_Click (object  sender,  EventArgs  e)  { 
this. Click  +=new  EventHandler (SaySomething) ; 

1 

private  void  button2_Click (object  sender,  EventArgs  e)  ( 
this. Click  +=new  EventHandler (SaySomethingElse) ; 

) 


Now  run  your  program  and  do  this: 

*  Click  the  form  you’ll  see  a  message  box  pop  up  that  says,  “You  just  clicked  on  the  form”. 

*  Now  click  buttonl  and  then  click  on  the  form  again.  You’ll  see  two  message  boxes 
pop  up:  “You  just  clicked  on  the  form”  and  then  “Something”. 

*  Click  button2  twice  and  then  click  on  the  form  again.  You'll  see  four  message  boxes: 
“You  just  clicked  on  the  form”,  “Something”,  “Something  else”,  and  “Something  else”. 


So  what  happened? 


Every  time  you  clicked  one  of  the  buttons,  you  chained  another  method — either  Something^)  or 
Some th ingElseQ — onto  the  form’s  Click  event.  You  can  keep  clicking  the  buttons,  and  they’ll  keep 
chaining  the  same  methods  onto  the  event.  The  event  doesn’t  care  how  many  methods  are 
chained  on,  or  even  if  the  same  method  is  in  the  chain  more  than  once.  It’ll  just  call  them  all  every 
time  the  event  fires,  one  after  another,  in  the  order  they'  were  added. 


j  The  same  method 

[^SomitSgEise(^;  “ 

■  J  than  onde 

SaySomethingElseQ  ||  - - 


more 


you  are  here 
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Connecting  event  senders  with  event  receivers 

One  of  the  trickiest  things  about  events  is  that  the  sender  of  the  event  has 
to  know  what  kind  of  event  to  send — including  the  arguments  to  pass  to  the 
event.  And  the  receiver  of  the  event  lias  to  know  about  the  return  type  and  the 
arguments  its  handler  methods  must  use. 

But  and  here's  the  tricky  part  you  can't  tie  the  sender  and  receiver  together. 

You  want  the  sender  to  send  the  event  and  not  worry  about  who  receives  it.  And  the 
receiver  cares  about  the  event,  not  the  object  that  raised  the  event.  So  Ixith  sender 
and  receiver  focus  on  the  event,  not  each  other. 


foil  needs 
about 

betake 

raise  that  event 


°b. ject 


foil  does  NOT  want  to  worry 
about  Pitcher.  It  doesn't  care 
what  type  o£  object  works  with  d? 
Pa*,  Pi+ther.  Umpire)  etc- 


"My  people  will  get  in  touch  with  your  people." 


You  know  what  this  code  does: 

Ball  currentBall; 

It  creates  a  reference  variable  that  can  point  to  any  Ball  object.  It's  not  tied 
to  a  single  Ball.  Instead,  it  can  point  to  any  ball  object — or  it  can  be  null,  and 
not  point  to  anything  at  all. 

An  event  needs  a  similar  kind  of  reference  except  instead  of  pointing  to  an 
object,  it  needs  one  that  points  to  a  method  Every  event  needs  to  keep  track 
of  a  list  of  methods  that  are  subscribed  to  it.  You’ve  already  seen  that  they  can 
be  in  other  classes,  and  they  can  even  be  private.  So  how  does  it  keep  track  of 
all  of  the  event  handler  methods  that  it  needs  to  call? 
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A  delegate  STANDS  IN  for  aw  actual  method 

One  of  the  most  useful  aspects  of  events  is  that  when  an  event  fires,  it  has  no  idea 
whose  event  handler  methods  it’s  calling.  Anyone  who  happens  to  subscribe  to  an  event 
gets  his  event  handler  called.  So  how  does  the  event  manage  that? 

It  uses  a  G#  type  called  a  delegate.  A  delegate  lets  you  create  a  reference  variable,  but 
instead  of  referring  to  an  instance  of  a  class,  it  refers  to  a  method  inside  a  class. 

You’ve  actually  already  been  using  delegates  thoughout  this  chapter!  When  you 
created  the  BalllnPlay  event,  you  used  EventHandler.  Well,  an  EventHandler 
is  just  a  delegate.  If  you  right-click  on  EventHandler  in  the  IDE  and  select  “Go  to 
definition  ’,  this  is  what  you'll  see  (try  it  yourself): 


When  you  Create  a 
delegate,  all  you  need 
to  do  is  specify  -the 
signature  of  methods 
that  rt  Can  point  to. 

I 

So  this  delegate  can  be 
used  to  reference  any 
method  that  takes  an 
object  and  an  EventArgs 
and  has  no  return  value 


public  delegate  void  EventHandler (object  sender,  EventArgs  e) 


This  specifies  the  return  value  of  the  delegates  ^ _  7-^  r  .  ,  . 

signature— which  means  an  EventHandler  Can  only  EventHandler  ’  ^  “ 


iignatu' 

point  to  methods  with  void  return  values 


A  delegate  adds  a  new  type  to  your  project 


Do  tjiis 

T-  4" 


W  hen  you  add  a  delegate  to  your  project,  you’re  adding  a  delegate  type.  And  when  you  use  it  to  create  a  field  or 
variable,  you’re  creating  an  instance  of  that  delegate  type.  So  create  a  new1  project.  Then  add  a  new  class  file  to 
the  project  called  RetumsAString.cs.  But  instead  of  putting  a  class  inside  it,  add  a  single  line: 

ReturnsAString  is  a  delegate  type  that  you've  added  to  your 
project  Now  you  can  use  it  to  declare  variables  and  fields 


public  delegate  string  ReturnsAString () ; 


Go  to  the  form  code  and  add  this  field  to  the  form: 

ReturnsAString  someMethod;  ^ ,s  '"sta^e  of  the 

delegate  type  ReturnsAString. 


Now  build  your  program — it  compiles!  (It  gets  a  warning  because  you  never  used  that  field — that’s  okay.)  As  soon  as 
you  added  your  new  delegate  to  the  program,  it  created  a  new  type  called  ReturnsAString.  If  you  use  that  type  to 
declare  a  variable,  you  can  set  that  variable  equal  to  any  method  that  lakes  no  parameters  and  returns  a  string.  Try’  it 
out  add  this  method  to  your  rode: 


private  string  HiTheref) 
return  "Hi  there!"; 

1 


This  method's  signature 
matches  ReturnsAString 


Add  a  button  that  has  these  three  lines.  Click  it  and  see  what  happens: 


someMethod  =  new  ReturnsAString (HiThere) ; 
string  message  =  someMethod 0 ; 

MessageBox.Show  (message)  ;  ybu  can  set  someMethod  just  like 

any  other  variable,  But  when  you  call 
it  like  a  method,  it  calls  whatever 
method  it  happens  to  point  to 


del-e-gate,  noun. 

a  person  sent  or 
authorized  to  represent 
others.  The  president  sent 
a  delegate  to  the  summit. 
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delegates  in  action 

There's  nothing  mysterious  about  delegates  in  fact,  they 
don’t  take  much  code  at  all  to  use.  Let’s  use  them  to  help  a 
restaurant  owner  sort  out  his  top  chef’s  secret  ingredients. 

Create  a  new  Windows  project  and  add  a  delegate 

Delegates  usually  appear  outside  of  any  other  classes,  so  add  a  new  class  file  to  your  project  and 
call  it  AddSecretIngredient.es.  It  will  have  exactly  one  line  of  code  in  it: 

public  delegate  string  GetSecretlngredient (int  amount); 

This  delegate  can  be  used  to  create  a  variable  that  can  point  to  any  method  that  takes  one  int 
parameter  and  returns  a  string. 


Add  a  class  for  the  first  chef,  Suzanne 

Suzanne.es  will  hold  a  class  that  keeps  track  of  the  fust  chef's  secret  ingredient.  It  luts  a  private 
method  called  SuzannesSecretlngredientQ  with  a  signature  that  matches  GetSecretlngredient. 
But  it  also  has  a  read-only  property  and  check  out  that  property’s  type.  It  returns  a 
GetSecretlngredient.  So  other  objects  can  use  that  property  to  get  a  reference  to  her 
SuzanneslngredientList()  method. 


public  class  Suzanne  { 

Suzanne's  secret  public  GetSecretlngredient  MySecretlngredientMethod  ( 
ingredient  method  get  { 

takes  an  int  return  new  GetSecretlngredient  (SuzannesSecretlngredient)  ; 

called  amount  and  1 

(returns  a  string  } 

that  describes  her  private  string  SuzannesSecretlngredient  (int  amount)  { 

secret  ingredient  ^ - *>  return  amount. ToStringO  +  "  ounces  of  cloves"; 

} 


} 


Then  add  a  class  for  the  second  chef,  Amy 

Amy’s  method  works  a  lot  like  Suzanne’s: 

public  class  Amy  { 


Amy's  GetSecretlngredient  property 
returns  a  new  instance  of  the 
GetSecretlngredient  delegate  that  s 
pointing  to  her  secret  ingredient  method 


public  GetSecretlngredient  AmysSecretlngredientMethod  { 

Amy's  secret  get  { 

inaredient  method  return  new  GetSecretlngredient (AmysSecretlngredient) ; 

also  takes  an  int  i 


called  amount  and  C  private  string  AmysSecretlngredient  (int  amount)  { 


returns  a  string, 
but  it  returns  a 
different  string 
from  Suzanne's. 


if  (amount  <  10) 

return  amount . ToString ( ) 

+  "  cans  of  sardines  —  you  need  more!"; 

else 

return  amount. ToStringO  +  "  cans  of  sardines"; 


} 
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Create  a  new  Windows  project  and  add  a  delegate 

Build  this  form. 

Here’s  the  code  for  the  form: 

GetSecretlngredient  ingredientMethod  =  null; 
Suzanne  suzanne  =  new  Suzanne (); 

Amy  amy  =  new  Amy  ( ) ; 


private  void  useIngredient_Click (object  sender,  EventArgs  e)  ( 
if  (ingredientMethod  !=  null) 

Console .WriteLine ("1' 11  add  "  +  ingredientMethod ( (int) amount. Value) ) ; 

else 


) 


Console. WriteLine ("I  don't  have  a  secret  ingredient!"); 


private  void  getSuzanne_Click (object  sender,  EventArgs  e)  ( 

ingredientMethod  =  new  GetSecretlngredient (suzanne. MySecret IngredientMethod) ; 

) 

private  void  getAmy_Click (object  sender,  EventArgs  e)  { 

ingredientMethod  =  new  GetSecretlngredient (amy .AmysSecretlngredientMethod) ; 

) 


Use  the  debugger  to  explore  how  delegates  work 

You’ve  got  a  great  tool-  the  IDE’s  debugger  -that  really  help  you  get  a  handle  on  how  delegates 
work.  Do  the  following  steps: 

*  Start  by  running  your  program.  First  dick  the  “Get  the  ingredient”  button  it  should  write  a 
line  to  the  console  that  says,  “I  don’t  have  a  secret  ingredient.” 

*  Click  the  “Use  Suzanne’s  delegate”  button — that  takes  the  form’s  ingredientMethod 
field  (which  is  a  GetSecretlngredient  delegate)  and  set  it  equal  to  whatever  Suzanne’s 
GetSecretlngredient  property  returns.  That  property  returns  a  new  instance  of  the 
GetSecretlngredient  type  that’s  pointing  to  the  SuzannesSecretIngredient()  method. 

*  Click  the  “Get  the  ingredient”  button  again.  Now  that  the  form’s  ingredientMethod 
field  is  pointing  to  SuzannesSecretlngredientQ,  it  calls  that,  passing  it  the  value  in  the 
numeric UpDown  control  and  writing  its  output  to  the  console. 

*  Click  the  “Use  Amy’s  delegate”  button.  It  uses  the  Amy.GetSecret Ingredient  property  to  set 
the  form’s  ingredientMethod  field  to  point  to  the  Amys  Secret  Ingredient!)  method. 

*  Click  the  “Get  the  ingredient”  method  one  more  time.  Now  it  calls  Amy’s  method. 

*  Now  use  the  debugger  to  see  exactly  what’s  going  on.  Place  a  breakpoint  on  the  first  line 
of  each  of  the  three  methods  in  the  form.  Then  restart  the  program  (which  resets  the 
ingredientMethod  so  that  it’s  equal  to  null),  and  start  over  with  the  above  live  steps.  Use 
the  Step  Into  (FI  1)  feature  of  the  debugger  to  step  through  every  line  of  code.  Watch  what 
happens  when  you  click  “Gel  the  ingredient”.  It  steps  right  into  the  Suzanne  and  Amy 
classes,  depending  on  which  method  the  ingredientMethod  field  is  pointing  to. 
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Pool  Puzz]e 


Your  job  is  to  take  snippets  from  the  pool 
and  place  them  into  the  blank  lines  in  the 
code.  You  can  use  the  same  snippet  more 
than  once,  and  you  won't  need  to  use  all 
the  snippets.  Your  goal  is  to  complete  the 
code  for  a  form  that  writes  this  output  to 
the  console  when  its  buttonl  button  is 
clicked. 

Output 

Fingers  is  coming  to  get  you! 


public  Forml ( )  { 

InitializeComponent () ; 

this. _  +=  new  EventHandler  ( _ ); 

this. _  +=  new  EventHandler  ( _ ); 

) 

void  Towtruck (object  sender,  EventArgs  e)  { 

Console. Write ("is  coming  ; 

I 

void  Motorcycle (object  sender,  EventArgs  e)  ( 

buttonl. _  +=  new  EventHandler  ( _ ); 

) 

void  Bicycle (object  sender,  EventArgs  e)  { 

Console. WriteLine ("to  get  you!"); 

) 

void  _ (object  sender,  EventArgs  e)  ( 

buttonl. _  +=  new  EventHandler  (Dumptruck)  ; 

buttonl. _  +=  new  EventHandler  ( _ ); 

} 


void 


(object  sender,  EventArgs  e)  ( 


Console. Write ("Fingers  ") ; 


Load 

Save 

Open 

Close 

Click 

Scroll 


event 

delegate 

int 

private 

public 


Van 

Car 

Minivan 

Motorcycle 

Tricycle 


Airplane 

Bicycle 

Dumptruck 

Towtruck 

Flatbed 


Note:  each  thing  from 
the  pool  can  be  used 
more  than  once 
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Any  object  can  subscribe  to  a  public  event... 

Suppose  we  add  a  new  class  to  our  simulator,  a  Bat  class,  and  that  class  adds  a 
HitTheBall  event  into  the  mix.  Here’s  how  it  works:  ir  the  simulator  detects  that  the 
player  hit  the  ball,  it  calls  the  Bat  object’s  OnHitTheBall  ( )  method,  which  raises  a 
HitTheBall  event. 


•take  information  about 
bow  hard  the  swing  was, 
figure  out  the  distance 
and  trajectory,  and  raise 
BalllnPlay  event 


So  now  we  can  add  a  bat  HitTheBall  method  to  the  Ball  class  that  subscribes  to 
the  Bat  object’s  HitTheBall  event.  Then  when  the  ball  gets  hit,  its  own  event  handler 
calls  its  OnBalllnPlay  ( )  method  to  raise  its  own  event,  BalllnPlay,  and  the  chain 
reaction  begins.  Fielders  field,  fans  scream,  umpires  yell...  weVe  got  a  ball  game. 


he  simulator  detects  that 

.he  bat  collided  with  the  ball, 

.  t  calls  the  bat  objects 
3nrtitTheBallO  method 


Ball  subscribed  to  the 
HitTheBall  event 


HitTheBall  event 


Wh-oh1  These  balls  were 
supposed  to  be  held  in  reserve 
in  case  the  first  one  was  h.t 
out  of  the  ?ark- 


rr  sate'** 

HitTheBall  event 


...but  that's  not  always  a  good  thing! 

There’s  only  ever  going  to  be  one  ball  in  play  at  any  time.  But  if  the  Bat 
object  uses  an  event  to  announce  to  the  ball  that  it’s  been  hit,  then  any  Ball 
object  can  subscribe  to  it.  And  that  means  we’ve  set  ourself  up  for  a  nasty' 
little  bug  what  happens  if  a  programmer  accidentally  adds  three  more 
Ball  objects?  Then  the  batter  will  swing,  hit,  and  four  different  balls 
will  flyr  out  into  the  field! 


Bub  a  careless  yrogrammer  subsC 
them  all  to  the  bats  H,tTheBatl 
evert-  so  when  the  bat  h,t  the  ball 
that  the  ytcher  threw,  all  W  o 
them  flew  out  into  the  f *M. 

V 


bat_HitTheBall() 


bat  HitTheBall() 


bat_HitTheBall() 


bat  HitTheBallO 
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callbacks  to  the  rescue 


The  Case  of  the  Golden  Crustacean 


Henry  “Flatfoot”  Hodgkins  is  a  TreasureHunter.  He’s  hot  on  the  trail  of  one  of  the  most 
prized  possessions  in  the  rare  and  unusual  aquatic-themed  jewelry  markets:  a  jade-encrusted 
translucent  gold  crab.  But  so  are  lots  of  other  TreasureHunters.  They  all  got  a  reference  to 
the  same  crab  in  their  constructor,  but  Henry  wants  to  claim  the  prize  first. 


Five  Minute 
Mystery 


In  a  stolen  set  of  class  diagrams,  Henry  discovers  that  the  GoldenCrab  class  raises  a 
RunForCover  event  every  time  anyone  gets  close  to  it.  Even  better,  the  event  includes 
NcwLocationArgs,  which  detail  where  the  crab  is  moving  to.  But  none  of  the  other 
treasure  hunters  know  about  the  event,  so  Henry  figures  lie  can  cash  in. 

Henry  adds  code  to  his  constructor  to  register  his  EistenForClues()  method  as  an 
event  handler  for  the  RunForCover  ev  ent,  on  the  crab  reference  he’s  got.  Then,  he 
sends  a  lowly  underling  after  the  crab,  knowing  it  will  run  away,  hide,  and  raise  the 
RunForCover  event  giv  ing  Henry’s  ListenFbrGluesQ  method  all  the  information  lie  needs. 


Everything  goes  according  to  plan,  until  Henry  gets  the  new  location  and  rushes  to  grab  the 
crab.  He’s  stunned  to  see  three  other  TreasureHunters  already  there,  fighting  over  the  crab. 


How  did  the  other  treasure  hunters  beat  Henry  to  the  crab? 


Answers  on  page  511. 


The  Constructor 
thams  two  event 
handlers  onto 
the  load  events 

They  yt  tired 

otf  as  soon 
as  the  £or»  IS 
loaded 


When  the  button' 
is  clicked,  it  calls 
the  three  event 
handlers  that  are 
chained  to  it- 


public  FormlO  ( 

InitializeComponent () ; 

this. Load  +=  new  EventHandler (Minivan) ; 

this. Load  +=  new  EventHandler  (Motorcycle) ; 

) 

void  Towtruck (object  sender,  EventArgs  e)  ( 
Console. Write ("is  coming  ") ; 

) 

void  Motorcycle (object  sender,  EventArgs  e)  { 
buttonl .  Click  +=  new  EventHandler  (Bicycle)  ;  ^ 

void  Bicycle  (object  sender,  EventArgs  e)  { 
Console. WriteLine ("to  get  you!"); 

) 

void  Minivan  (object  sender,  EventArgs  e)  ( 

buttonl .  Click  +=  new  EventHandler (Dumpt ruck) 
buttonl .  Click  +=  new  EventHandler  (Towtruck)  ; 

1 

void  Dumptruck  (object  sender,  EventArgs  e)  { 
Console. Write ("Fingers  ") ; 

) 


poo]  Puzzje 
^ojufion 


TV  two  Load  event  handlers 
hook  up  three  separate  event 
handlers  to  the  button's 
Ckk  event  handler. 
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Use  a  callback  instead  of  an  event  to  hook  up 
exactly  one  object  to  a  delegate 

Our  system  of  events  only  works  if  we’ve  got  one  Ball  and  one  Bat.  If  you’ve  got  several  Ball 
objects,  and  they  all  subscribe  to  the  public  event  HitTheBall,  then  they’ll  all  go  flying  when 
tlte  event  is  raised.  But  that  doesn't  make  any  sense...  it's  really  only  one  Ball  object  Unit  got  hit. 
We  need  to  let  the  one  ball  that’s  being  pitched  hook  itself  up  to  the  bat,  but  we  need  to  do  it  in  a 
way  that  doesn’t  allow  any  other  balls  to  hook  themselves  up.  And  that’s  what  a  callback  is — it’s 
a  way  of  using  a  delegate  so  the  object  that’s  calling  it  is  guaranteed  to  only  call  the  one  method 
that  it  needs  to  call,  and  no  other  method  can  chain  itself  onto  the  delgate. 

Here’s  how  the  callback  will  work: 


The  Bat  will  keep  its  delegate  field  private 

The  easiest  way  to  keep  the  wrong  Ball  objects  from  chaining  themselves  onto  the  Bat’s 
delegate  is  for  the  bat  to  make  it  private.  That  way,  it  has  control  over  which  Ball  object’s 
method  gets  called. 


The  Ball's  constructor  takes  a  delegate  that  points  to  a  method  in  the  ball 

When  the  ball  is  in  play,  it  creates  the  new  instance  of  the  bat,  and  it  passes  the  Bat  object  a 
pointer  to  its  OnBalllnPlayO  method.  This  is  called  a  callback  method  because  the  Bat  is 
using  it  to  call  back  to  the  object  that  instantiated  it. 


The  Ball  object  passes  a  delegate 
reference  to  its  own  OnBalllnPlayO 
method  to  the  Bat's  Constructor 
The  bat  saves  that  delegate  in  its 
private  bitTbeBallCallback  -field 


When  the  bat  hits  the  ball,  it  calls  the  callback  method 

But  since  the  bat  kept  its  delegate  private,  it  can  be  100%  stuc  that  no  other  ball  has  been  hit. 


hitBallCallback 


OnBalllnPlayO 


HitTheBall() 


Now  the  Bat  object  can 
call  its  hitBallCallback 
delegate,  which  calls 
the  Ball  object's 
OnBalllnPlayO  method 


The  other  balls  can’t 
Chain  themselves  onto 
the  delegate  because 
it’s  a  private  -field  in 
the  Bat  object 


BallHasBeenHit( 


BallHasBeenHit( 


BallHasBeenHit( 
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leave  a  message  i'll  call  you  back 


Callbacks  use  delegates,  but  NOT  events 

A  callback  is  a  different  way  of  using  a  delegate.  It's  not  a  new 

keyword  or  operator.  It  just  describes  a  pattern  -a  way  that  you  use 
delegates  with  your  classes  so  that  one  object  can  tell  another  object, 
"Notify  me  when  this  happens — and  don’t  tell  anyone  else!” 


method,  we  ll  need  a  delegate  that  matches  its  signature: 

public  delegate  void  BatCallback (BallEventArgs  e) 


Add  another  delegate  to  your  Baseball  project 

Since  the  Bat  will  have  a  private  delegate  field  that  points  to  the  Ball  object’s  OnBalllnPlayQ 

The  Bat  object's  callback  will  p<*nt  to  a 
Ball  objects  OnBalllnPlayO  method,  so 
the  callback  s  delegate  needs  to  match  the 
signature  of  OnBallfnPlayO  —so  it  needs  to 
take  a  BallEventArgs  parameter  and  have 

Add  the  Bat  class  to  the  project  a  void  return  value 

I  he  Bat  class  is  simple.  It's  got  a  HitlTteBallQ  method  that  the  simulator  will  call  every  time 
a  ball  is  hit.  That  HitThcBallQ  method  uses  the  hitBallCallback!)  delegate  to  call  the  ball's 
OnBalllnPlayQ  method  (or  whatever  method  is  passed  into  its  constructor). 

public  class  Bat  { 


Make  sure  you 
check  every 
delegate  to 
make  sure 
it's  not  null, 
otherwise  it 
Could  throw  a 
null  reference 
exception  j 


private  BatCallback  hitBallCallback; 
public  Bat (BatCallback  callbackDelegate)  ( 

this. hitBallCallback BatCallback (callbackDelegate) ; 

) 

public  void  HitTheBall (BallEventArgs  e) 

_ if  (hitBallCallback  !=  null) 

hitBallCallback (e) ; 

) 


We  used  —  instead  of  +—  because 
there's  no  need  to  chain-  This  delegate 
only  gets  set  once-  But  if  you  really 
feel  like  using  +—  instead,  it  II  work 
vust  fine- 


We’ll  need  to  hook  the  bat  up  to  a  ball 

So  how  does  the  Bat’s  constructor  get  a  reference  to  a  particular  ball’s  OnBallInPlay()  method? 
Easy  just  call  that  Ball  object’s  GetNewBatQ  method,  which  you’ll  have  to  add  to  Ball: 


public  Bat  GetNewBatO 


< 

return  new  Bat (new  BatCallback (OnBalllnPlay) ) ; 


The  Ball's  GetNewBatO  method 
creates  a  new  Bat  object,  and  it  uses 
the  BatCallBack  delegate  to  pass  a 
reference  to  its  own  0nBall|nPlayO 
method  to  the  new  bat  That's  the 
callback  method  the  bat  will  use  when 
it  hits  the  ball. 
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Now  we  can  encapsulate  the  Ball  class  a  little  better 

It's  unusal  for  one  of  the  On .  .  .  methods  that  raise  an  event  to  be  public.  You  can  check  this  for 
yourself  go  to  the  form  and  try  to  call  the  playBall  button’s  OnGlickQ  event.  You  won’t  be  able 
to,  because  it’s  protected  (so  a  subclass  can  override  it).  So  let’s  follow  that  pattern  with  our  ball 
too,  by  making  its  OnBalllnPlayO  method  protected: 

protected  void  OnBalllnPlay  (BallEventArgs  e)  h  3  really  standard  pattern  that  yc*  II 

{  see  over  a*d  over  apm  "be*  y°“  'work 

if  (BalllnPlay  !=  null)  K  f^T  classes.  When  a  NfcT  class  has  an  event 

BalllnPlay  (this,  e) ;  V - -  that  ^ets  {wed,  you'll  almost  always  Ud  a 

1  frotetted  method  that  starts  w,th  0*  - 


All  that’s  left  to  do  is  hook  up  the  form 

The  form  can’t  call  the  Ball  object’s  OnBalllnPlayO  method  anymore — which  is  exactly  what  we 
wanted.  That’s  why  we  set  up  the  Ball.GetNewBat()  method.  Now  the  form  needs  to  ask  the  Ball 
for  a  new  bat  in  order  to  hit  the  ball.  And  when  it  does,  the  Ball  object  will  make  sure  that  its 

l-f  the  -form  (or  the  simulator)  wants 
to  hit  a  Ball  object,  it  needs  to 
$et  a  new  Bat  object  -from  that 
ball.  The  ball  will  make  sure  that 


OnBalllnPlayO  method  is  hooked  up  to  the  bat’s  callback. 

private  void  playBall_Click (object  sender,  EventArgs  e) 

^ - - 


( 


Bat  bat  =  ball . GetNewBat () ; 

BallEventArgs  ballEventArgs  =  new  BallEventArgs ( 
(int) trajectory .Value,  (int) distance .Value) ; 
bat.HitTheBall (ballEventArgs) ; 


the  callback  is  hooked  up  to  the  bat 
Now  when  the  -form  calls  the  bat’s 
HitTheBallO  method,  it  calls  the 
ball  s  OnBalllnPlayO  method,  which 
£ires  its  BalllnPlay  event  A 

Now  run  the  program  it  should  work  exactly  like  it  did  before.  But  it’s  now  protected  from 

any  problems  that  would  be  caused  by  more  than  one  ball  listening  for  the  same  event.  t 

But  don't  take  our  word  -for  it— pop  it  open  in  the  debufjger^ 


BULLET  POINTS 


■  When  you  add  a  delegate  to  your  project,  you're 
creating  a  new  type  that  stores  references  to  methods 

■  Events  use  delegates  to  notify  objects  that  actions  have 
occurred. 

■  Objects  subscribe  to  an  object's  event  if  they  need  to 
react  to  something  that  happened  in  that  object. 

■  An  EventHandler  is  a  kind  of  delegate  that's  really 
common  when  you  work  with  events. 

■  You  chain  several  event  handlers  onto  one  event.  That's 
why  you  use  +=  to  assign  an  handler  to  an  event. 

■  Always  check  that  an  event  or  delegate  is  not  null  before 
you  use  it  to  avoid  a  NullReferenceException. 


All  of  the  controls  in  the  toolbox  use  events  to  make 
things  happen  in  your  programs. 

When  one  object  passes  a  reference  to  a  method  to 
another  object  so  it— and  only  it— can  return  information, 
it's  called  a  callback. 

Events  let  any  method  subscribe  to  your  object's  events 
anonymously,  while  callbacks  let  your  objects  exercise 
more  control  over  which  delegates  they  accept. 

Both  callbacks  and  events  use  delegates  to  reference 
and  call  methods  in  other  objects. 

The  debugger  is  a  really  useful  tool  to  help  you 
understand  how  events,  delegates,  and  callbacks  work 
Take  advantage  of  iff 
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tliere.ore  no 

Dumb  Questions 


V:  How  are  callbacks  different  from  events? 

Events  are  part  of  C#.  They  re  a  way  for  one  object  to 
announce  to  other  objects  that  something  specific  has  happened- 
When  one  object  publishes  an  event,  any  number  of  other  objects 
can  subscnbe  to  it  without  the  publishing  object  knowing  or  caring. 
When  an  object  fires  off  an  event,  if  anyone  happens  to  have 
subscribed  to  it  then  it  calls  each  of  their  event  handlers. 

Callbacks  are  not  published.  Instead,  a  callback  establishes  a 
relationship  between  two  clases  where  one  object  automatically 
reacts  to  another  A  callback  is  generally  kept  private,  and  the  class 
that  stores  the  callback  maintains  control  over  who  has  access  to  it.  A 
callback  is  often  set  up  in  an  object's 

Oj 

So  a  callback  isn't  an  actual  type  in  C#? 

No,  it  isn't.  A  callback  is  a  pattern— it  s  just  a  novel  way  of 
using  the  existing  types,  keywords  and  tools  that  C#  comes  with.  Go 
back  and  take  another  look  at  the  callback  code  you  just  wrote  for  the 
Bat  and  Ball  Did  you  see  any  new  keywords  that  we  haven  t  used 
before?  Nope! 

It  turns  out  that  there  are  a  lot  of  patterns  that  you  can  use.  In  fact, 
there's  a  whole  area  of  programming  called  design  patterns  There 
are  a  lot  problems  that  you'll  run  into  which  have  been  solved  before, 
and  the  ones  that  pop  up  over  and  over  again  have  their  own  design 
patterns  that  you  can  benefit  from.  A 


O:  So  callbacks  are  just  private  events? 

Not  quite.  It  seems  easy  to  think  about  it  that  way,  but  private 
events  are  a  different  beast  altogether.  Remember  what  the 
private  access  modifier  really  means?  When  you  mark  a  class 
member  private,  only  instances  of  that  same  class  can  access  it  So 
if  you  mark  an  event  private,  then  other  instances  if  the  same 
class  can  subscribe  to  it.  That’s  different  from  a  callback,  because 
it  still  involves  one  or  more  objects  anonymously  subscnbing  to  an 
event. 

o 

But  it  looks  just  like  an  event,  except  with  the  event 
keyword,  right? 

The  reason  a  callback  looks  so  much  like  an  event  is  that 
they  both  use  delegates  And  it  makes  sense  that  they  both  use 
delegates,  because  that's  C#'s  tool  for  letting  one  object  pass 
another  object  a  reference  to  one  of  its  methods 

But  the  big  difference  between  normal  events  and  callbacks  is 
that  an  event  is  a  way  for  a  class  to  publish  to  the  world  that  some 
specific  thing  has  happened  A  callback,  on  the  other  hand,  is  never 
published.  It's  private,  and  the  method  that's  doing  the  calling  keeps 
tight  control  over  who  it's  calling 


Check  out  "Head  First  Des,y  Patterns”  at  the  Head  F-rst 
Labs  website  It’s  a  yeat  way  to  learn  about  di+terent 
patterns  that  you  Can  apply  to  your  own  programs. 

wwwheadf irstlabs  Com/books/hf dp/ 


The  -first  one  you  II  learn  about  is  called 
the  "Publisher-Subscriber”  pattern,  and 
it'll  look  really  familiar  to  you  One  object 
publishes  information,  and  other  objects 
subscribe  to  it-  ttmmm... 
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The  Case  of  the  Golden  Crustacean 

How  did  the  other  treasure  hunters  beat  Henry  to  the  crab? 

The  crux  of  the  mystery  lies  in  how  the  treasure  hunter  seeks  his  quarry.  But 
first  we'll  need  to  see  exactly  what  Henry  found  in  the  stolen  diagrams. 

In  a  stolen  set  of  class  diagrams ,  Henry  discovers  that  the  Golden  Crab  class  raises 
a  RunForCover  event  even  time  anyone  gets  close  to  it.  Even  better,  the  event  includes 
fifewLocationArgs,  which  detail  where  the  crab  is  moving  to.  Rut  none  of  the  other 
treasure  lumters  blow  about  the  event,  so  Hairy  figures  he  can  cash  in. 


Minute 
Mystery 

iokei! 


public  class  GoldenCrab  { 

public  delegate  void  Escape (NewLocationArgs  e) ; 
public  event  Escape  RunForCover; 
public  void  SomeonesNearby ( )  1 

NewLocationArgs  e  =  new  NewLocationArgs ("Under  the  rock"); 
RunForCover (e) ; 

) 

1 

public  class  NewLocationArgs  { 

public  NewLocationArgs (HidingPlace  newLocation)  { 
this.newLocation  =  newLocation; 

) 

private  HidingPlace  newLocation; 

public  HidingPlace  NewLocation  {  get  {  return  newLocation;  )  ) 

1 


Any  time  someone  Comes 

the  golden  crab, 
its  Someones/\/ea*-byO 

method  -fires  o-ff  a 
RunForCover  event,  and 
•t  +mds  a  place  to  hide. 


So  how  did  Henry  take  advantage  of  his  newfound  insider  information? 

Henry  adds  code  to  his  constructor  to  register  his  ListenForCluesQ  method  as  an  event  handler  for  the  RunForCover 
event,  on  the  crab  reference  he's  got.  Then,  he  sends  a  lowly  underling  after  the  trab,  knowing  it  will  run  away,  hide, 
and  raise  the  RunForCover  event — giving  Henry 's  ListenForCluesQ  method  all  the  information  he  needs. 


public  class  TreasureHunter  { 

public  TreasureHunter (GoldenCrab  treasure)  { 

treasure. RunForCover  +=  new  GoldenCrab. Escape (treasure_RunForCover) ; 


1 

void  treasure_RunForCover (NewLocationArgs 
MoveHere (e. NewLocation) ; 

) 

void  MoveHere (HidingPlace  Location)  ( 

//  ...  code  to  move  to  a  new  location 

) 

1 


>  <  Henry  thought  he  was  being  clever  by  aiding  h.s 
fcr  class’s  Constructor  to  add  an  event  handler  that  tails 
^  his  MoveHereO  method  every  feme  the  Crab  raises  its 
RunForCover  event  But  he  forgot  that  the  other 
‘  •  treasure  hunters  inherit  from  the  same  class,  and  h.s 

clever  code  adds  their  event  handlers  to  the  chain,  too 


And  that  explains  why  Henry’s  plan  backfired.  W  hen  he  added  the  event  handler  to  the  TreasureHunter 
constructor,  he  was  inadvertently  doing  the  same  thing  for  all  of  the  treasure  hunters!  And  that 
meant  that  every  treasure  hunter's  event  handler  got  chained  onto  the  same  RunForCover  event.  So  when 
the  Golden  Crustacean  ran  for  cover,  everyone  was  notified  about  the  event..  And  all  of  that  that  would 
have  been  fine  if  Henry  were  the  first  one  to  get  the  message.  But  Henry  had  no  way  of  knowing  when  the 
other  treasure  hunters  would  have  been  called — if  they  subscribed  before  he  did,  they’d  get  the  event  first. 
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whack  that  mole! 


^Sharpen  your  pencil 


public  partial  class  Forml  :  Form  { 
Mole  mole; 

Random  random  =  new  Random ( ) ; 
public  Forml 0  ( 

InitializeComponent ()  ; 


Fill  in  the  blanks  to  make  this  game  of  Whack-a-mole 
work.  You  need  to  supply  the  code  that  does  the 
callbacks.  Once  you've  got  it  filled  in,  go  ahead  and 
type  it  into  the  IDE.  Or  you  can  try  to  get  it  working  in 
the  IDE,  and  then  fill  in  the  blanks  afterwards.  It's  fun! 


mole  =  new  Mole (random,  new  Mole._ 
timerl . Interval  =  random. Next (500, 
timerl .Start () ; 


)) 


1000) 


private  void  timerl_Tick (object  sender,  EventArgs  e)  { 
timerl. Stop () ; 

ToggleMole () ; 

I 


private  void  ToggleMole ()  ( 

This  method's  if  (mole. Hidden  ==  true) 

tailed  to  pop  ^-le.ShowO; 

up  or  hide  mole.HideAgainO  ; 

the  mole  whentimerl .  Interval  =  random. Next  (500, 
the  timer’s  timerl .  Start  ( )  ; 

elapsed-  private  void  MoleCallBack  (int  MoleNumber, 
if  (MoleNumber  <  0)  ( 
timerl .Stop () ; 
return; 

) 


T  The  -form  passes  a  delegate 
x  pointing  to  a  callback 
method  into  the  mole  s 
Constructor  Fill  it  in- 

Wen  V*.  double-click  on  the  timer  in  the 

i^lDF  n  **  *  **  *  toolbox), 

the  (DE  w.ll  create  this  event  handler  &r  ,t 
.mers  Ire  the  Tick  event  over  and  over  agam 
You  learn  all  about  them  in  the  next  chapter. 

1000);  r 


bool  Show)  ( 

Fomil.cs  (Design) 


■  Whack-a-molc 


-  X 


This  switch 
makes  sure 
that  the 
right  button 
Changes  its 
£olor  and 
text. 


Button  button; 
switch  (MoleNumber)  { 

case  0;  button  =  buttonl;  break; 
case  1:  button  =  button2;  break; 
case  2;  button  =  button3;  break; 
case  3:  button  =  button4;  break; 
default:  button  =  button5;  break; 


) 


(Show  ==  true)  { 
button. Text  =  "HIT 
button. BackColor  = 
else  { 

button. Text  = 
button. BackColor  = 


ME!"; 

Color. 


Red; 


■■  This  is  a  Timer  Control 
0  timer  l  Drag  it  out  o(  the  -toolbox, 
^  then  double— click  on  it- 


SystemColors .Control; 


timerl , 
timerl , 


Interval  = 
Start () ; 


random. Next (500,  1000) 


) 

private  void  button l_Click (object  sender,  EventArgs  e) 
mole . Smacked (0) ; 

> 

Just  add  these  event  handlers  the  usual  way 
by  double— clicking  in  the  -form  designer 


IfVhen  you  type  in  the  Code,  add 
■five  button  event  handlers 
Have  buttonZ_cliekO  call  mole- 
{  Smacked(l),  and  then  make 
button^  call  mole  Smacked(Z), 
and  make  button^-  call  mole- 
Smacked(3)  and  button?  call 
moleSmaekedW- 
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public  class  Mole  { 
public  _ 


void  PopUp (int  hole,  bool  show); 


private 


popUpCa 1 lba  c  k ; 


private  bool  hidden; 
public  bool  Hidden  {  get  {  return  hidden;  )  } 
private  int  timesHit  =  0; 
private  int  timesShown  =  0; 
private  int  hole  =  0; 

Random  random; 


Fill  in  the  delegate  and  field  to 
hold  the  dele*ate-they're  both 
at  the  top  of  the  Mole  dlass. 

Here’s  where  we  make  sure  the  dallbadk 
is  not  null — if  it  is,  the  Mole  objedt 
throws  3n  Ar<\umentF*deption 

4/ 


public  Mole (Random  random,  PopUp  popUpCa llback)  { 
if  (popUpCallback  ==  null) 

throw  new  ArgumentException ("popUpCallback  can't  be  null"); 
this. random  =  random; 

When  the  dreatds  a  new  Mole 

this .  =  ;  obiedt,  it  passes  it  a  referende 

.  ‘J  .  .<!  .  Il  I  T-l.-  - 


hidden  -  true; 


) 


public  void  Show()  ( 
timesShown++; 
hidden  =  false; 
hole  =  random. Next (5) ; 


public  void  HideAgainO  ( 
hidden  =  true; 


(hole,  true), 


(hole,  false) 


Check For GameOver  () 


public 

if 


void  Smacked (int  holeSmacked) 
(holeSmacked  ==  hole)  { 
timesHit++; 
hidden  =  true; 
CheckForGameOver ( ) ; 


(hole,  false) , 


) 


< 


private  void  CheckForGameOver () 
if  (timesShown  >=10)  { 

popUpCallback (-1,  false); 
MessageBox. Show ("You  scored 
Application . Exit ( ) ; 


^  to  its  dallbadk  method  Take  a 

look  in  the  form  to  see  how  the 
donstrudtor  is  dalled,  and  then  -fill 
in  this  blank 

A-fter  the  mole  shows  itsel-P  rt 
needs  to  tall  the  method  on' the 
+orm  that  displays  the  mole  by 
turning  the  button  red  and  showing 
the  text  “H|T  ME/"  3 

The  HideA^}  and  SmadkedO 
methods  also  use  the  dallbadk  delegate 
to  dall  the  method  on  the  torn,. 

The  way  the  game  works  is  that  it  uses  the 
timer  to  wait  a  random  period  of  time  between 
hal-f  a  sedond  and  J-5  sedonds  0nde  that  time 
is  elapsed,  it  tells  the  mole  to  show  itsel-P-  The 
■form  gives  the  Mole  objedt  a  dallbadk  that  it 
uses  to  tell  the  form  to  show  or  hide  the  mole 
in  one  of  the  f  ive  holes-  The  form  uses  its 
timer  to  wait  between  .5  and  1.5  sedonds  again, 
and  then  tells  the  mole  to  hide  itself 
+  timesHit,  "Game  over"), 


) 


) 


The  game’s  over  after  the  mole  shows  itself  10 
^ _ times.  Your  sdore  is  the  number  of  times  you  hit  it- 
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exercise  solution 


Fill  in  the  blanks  to  make  this  game  of  Whack-a-mole  work.  You  need  to  supply 
the  code  that  does  the  callbacks.  Once  you've  got  it  filled  in,  go  ahead  and 
type  it  into  the  IDE.  It's  fun! 


public  partial  class  Forml  :  Form  ( 

private  void  Forml _Load (object  sender, 

mole  =  new  Mole (random,  new  Mole._ 
timerl . Interval  =  random. Next (500, 
timerl. Start () ; 

I 


MoleCallPack 


EventArgs  e) 

PopUp  ( 

1000) ; 

This  is  where  the  form  passes  a  reference  to  its, 
/WoleCallBackO  method  into  the  /Wole  object-  That 
lets  the  mole  Call  rts  method- 


public  class  Mole  ( 

public  delegate 

private  PopUp 


void  PopUp(int  hole,  bool  show); 
popUpCallback; 


Here's  where  the  mole  defmes  its 
delegate  and  uses  it  to  set  up  a 
private  f  ield  to  hold  a  reference 
,to  the  method  on  the  form  that 
Changes  the  Colors  of  the  buttons 


public  Mole (Random  random,  PopUp  popUpCallback)  { 
this. random  =  random; 


this.  popUpCallback 

hidden  =  true; 

) 

public  void  Show()  ( 
timesShown++; 
hidden  =  false; 
hole  =  random. Next (5) ; 

popUpCallback  _ (hole, 

) 


popUpCallback  . 


true) ; 


When  the  form  Creates  a  new  instance  of 
the  /Wole  object,  it  passes  a  reference  to  its 
MoleCallBackO  method  to  the  Constructor 
as  a  parameter  This  line  in  the  Constructor 
Copies  that  reference  to  its  popUpCallback 
field  Its  methods  can  use  that  field  to  call 
the  /MoleCallBackO  method  in  the  form. 


public  void  HideAgainO  ( 
hidden  =  true; 


popUpCallback  lhole.  false>, 

CheckForGameOver ( ) ; 

) 

public  void  Smacked (int  holeSmacked)  ( 
if  (holeSmacked  ==  hole)  ( 
timesHit++; 
hidden  =  true; 

CheckForGameOver ( ) ; 


Wke.  th,  -ol(  iWt  k“,es  " 

v.  vt,  sacked,  j. 

/  method  on  the  form  that  Change 
and  te*t  of  one  of  the  buttons. 


popUpCallback  (hole.  false); 

) 
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*  Knowledge,  power,  and 
building  cool  stuff 


I  just  know  I  read  about  how 
upcasting  and  downcasting  make 
event  handling  easier  somewhere... 


Learning’s  no  good  until  you  BUILD  something. 

Until  you’ve  actually  written  working  code,  it’s  hard  to  be  sure  if  you  really  get  some 
of  the  tougher  concepts  in  C#.  In  this  chapter,  we’re  going  to  leam  about  some  new 
odds  and  ends:  timers  and  dealing  with  collections  using  LINQ  (to  name  a  couple). 
We  re  also  going  to  build  phase  I  of  a  really  complex  application,  and  make  sure 
you’ve  got  a  good  handle  on  what  you've  already  learned  from  earlier  chapters.  So 
buckle  up  .it's  time  to  build  some  cool  software 


this  is  a  new  chapter 
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my  brain's  full 


You've  come  a  long  way. 


We’ve  come  a  long  way  since  we  fu  st  used  the  IDE  to  help  us  rescue  the 
Objectville  Paper  Company.  Here’s  just  a  few  of  the  things  you’ve  done 
over  the  last  several  hundreds  pages: 


Cn°^  ^om  Kur"dn  source*  "baby"  i,  no  Utter 
Hct-daHy  Please  use 

ln+ar«t  to  avend  offendm9  readers..] 


You  ve  used  inheritance,  as  well 
f  '"cer faces  and  subclasses, 
to  build  object  trees 


You've  built  ■forms,  used  the 
KE T  framework,  and  even 
talked  with  databases 


NET  Framework 
solutions 


Navigator 


SetDestinatcnl) 

ModifyRouteToAvoidl) 

ModifyftouteTo4nc*ide() 

GelRouteO 

GetTimeToDesDnatronO 

TotaOstanceO 


7  wt  variables 


BalllnPlay  evei 


private  void  RandcttExcuseBatton_Click<obiect  sendee.  EventArqs  el 


_ ^ _ _ 

DinnerParty 

, - ^ - a 

BirthdayParty 

NumberOfPeopte 

CoMOfDoaxatons 
CoslOfBeveragesPerPerKjn 
Healthy  Option 

NimbetCHPeopte 

Co«OtDecof  adore 
[1  CafceSize 

CakeWntnfl 

(^k^la1eCoetOfDecofabcrt9ii 

Cattfa1eCo9lOC)ecofal>or»(l 

CateutateCastl) 

R  CataiateCoatO 

Se(HealthyOption<) 
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We've  also  become  beekeepers 

Bark  in  Chapter  6,  we  built  some  bee  classes.  Remember  these? 


di fWt  bees 
doing  different  jobs... 


*  Hive  Maintenance  System 


Worker  Bee  Job  Assignments 
Worker  bee  job  Shrfts 


Hive  maintenance 

H 

1  Assian  Work  ] 

Hive  sh/t  report 

Report  tor  shirt  #26 

Worker  #1  ts  *Horey  menufedunng'  tor  2  more  shifts 

Worker  #2  will  be  done  with  tgg  core’  alter  t*s  shirt 
Worker  #3  iimsheo  the  job 
Worker  #3  is  not  working 

Worker  #4  is  ootrvg  'Nectar  collector*  lor  1  more  shifts 


The  queen  bee  says.. 


TTie  job  Baby  bee  tutoring'  wfl  be  done  in  3  shifts 


OK 


...and 

worked  on 


Put  we  caw  do  a  lot  better  now... 


Tbe  stats  window 


You’ve  learned  a  lot  since  Chapter  6.  though.  So  let’s  start  from 
scratch,  and  build  an  animated  beehive  simulator  over  the 


lets  us  monitor  tbe 
simulation  in  detail. 


■E332Q| 

i_  Paces  simulation  Reset 

aiJ  -i 

#  Bees 

0 

#  Flowers 

23 

Total  honey  in  the  hive 

14  950 

Total  nectar  in  the  field 

88  470 

Frames  run 

7781 

Frame  rale 

25  (40  1ms) 

Id  p  1  bps 


Fly  mgToFlower  4  bees 
GaiheringNectar  1  bee 
FteiumingToHive  2  bees 


Tha  HIv* 


next  few  chapters.  We’ll  end  up  with  a  user  interlace  that  shows 
us  the  hive  and  the  field  the  bees  are  keeping,  and  even  a  stats 
window  letting  users  know  what  their  bees  are  doing. 


We  can  even  watcb  tbe  bee 
work  a  -field  of-  -flowers. 


The  1W  Wmdw  *ows 
ws  wbat’s  ba??«*"^ 
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doesn't  look  too  tough...  right? 


The  beehive  simulator  architecture 


Here’s  the  architecture  for  the  bee  simulator.  Even 
though  the  simulator  will  be  controlling  a  lot  of  different 
bees,  the  overall  object  model  is  pretty  simple. 


I  ne  world  object  keeps  track  of 
everything  in  the  simulator-  the 
state  of  the  hive,  every  bee,  and 
every  flower.  1 


3rJw  of  Wes.  **  -•«  W*  4  ^ 

in  the  ne*t  chapter- 


f 


This  is  the  object  ( or  the  mam 
window  that  shows  the  bee 
stats  and  messages 


locaxion  toutside  the 

h've  at  point  n°r,  It 

f*  *^tc  ^"-flying 
to  a  flower",  "gather, 
*ctar",  "making  hone 


World  represents  the 
entire  thing 


<r 

Well  reed  Flower  objects 
for  each  flower. 


Th# 


II' uV  ■*« 

+0*-  the  bees. 


/\nd  of  Course,  **  " 
need  a  Bee  class- 


51 8  Chapter  12 


review  and  preview 


Puildiwg  the  beehive  simulator 

Of  course,  we’ve  never  built  anything  this  complex  before, 
so  it’s  going  to  take  us  a  couple  of  chapters  to  put  all  the 
pieces  together.  Along  the  way;  you’ll  add  timers,  L1NQ. 
and  a  lot  of  graphical  skill  to  your  toolkit. 

Here’s  what  you're  going  to  do  in  this  chapter  (more  to 
come  in  the  next): 


O  Build  a  Flower  class  that  ages,  produces  nectar, 
and  eventually  wilts  and  dies. 

O  Build  a  Bee  class  that  has  several  different  states 
(gathering  nectar  from  a  flower,  returning  to  the 
Hive),  and  knows  what  to  do  based  on  its  state. 

O  Build  a  Hive  class  that  has  an  entrance,  exit, 
nursery  for  new  bees,  and  honey  factory  for 
turning  collected  nectar  into  honey. 

©  Build  a  World  class  that  manages  the  hive, 
flowers,  and  bees  for  any  given  moment. 

O  Build  a  main  form  that  collects  statistics  from  the 
other  classes,  and  keeps  the  world  going. 
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stop  and  smell  the  flowers 


E*e*ctSe 


Let's  jump  right  into  some  code.  First  up,  we  need  a  Flower  class.  The  Flower  class  has  a 
location,  defined  by  a  Point,  an  age.  and  a  lifespan.  As  time  goes  on,  the  flower  gets  older.  Then, 
when  its  age  reaches  its  lifespan,  the  flower  dies.  It's  your  job  to  put  all  this  into  action. 


Write  the  skeleton  code  for  Flower 


«  i.  is  \ust  tts  t>eM> 

/-A  s  e  j  declarator 


Below  is  the  class  diagram  for  Flower.  Write  the  basic  class  skeleton.  Location, 

Age,  Alive,  Nectar,  and  NectarHarvested  are  automatic  properties. 
NectarHarvested  is  writable,  the  other  four  are  read-only.  For  now,  leave  the  methods 


blank:  we’ll  come  back  to  those  in  a  minute. 


AH  o(  these 
should  be  read¬ 
only  properties 

This  is  used  only  in  the 
tlass,  so  it  just  needs  to 
a  private  teld 


Flower 


Location:  Point 
Age:  int 
Alive:  bool 
Nectar:  double 
NectarHarvested:  double 
lifespan:  int 


F>e  variable- 


Add  several  constants  to  the  class 

We  need  lots  of  constants  for  flowers.  Add  six  to  your  Flower  class: 


♦  LifeSpanMin,  the  shortest  flower  lifespan 

♦  LifeSpanMax,  the  longest  flower  lifespan 

♦  InitialNectar,  how  much  nectar  a  flower  starts  with 

♦  MaxNectar,  how  much  nectar  a  flower  can  hold 


p/|,  you  don't  usually 
show  Constants  «n  a 

tlass  diagram 


♦  NectarAddedPerTurn,  how  much  nectar  gets  added  each  time  the  flower  grows  older 

♦  NectarGatheredPerTurn,  how  much  nectar  gets  collected  during  a  cycle 

You  should  lx*  able  to  figure  out  the  types  for  each  constant  based  on  their 
values.  Flowers  live  between  1 5,000  and  30,000  cycles,  and  have  1 .5  units 
of  nectar  when  they  start  out.  They  can  store  up  to  5  units  of  nectar.  In 
each  cycle  of  life,  a  flower  adds  0.01  units  of  nectar,  and  in  a  single  cycle, 

0.3  units  can  be  collected. 
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You’ll  need  to  add  using  System. Drawing;  to  the  top  of  any  class  file  that  uses  a  Point. 


Build  the  constructor 

The  constructor  for  Flower  should  take  in  a  Point,  indicating  the  flower’s  location,  and  an 
instance  of  the  Random  class.  You  should  be  able  to  use  those  arguments  to  set  the  location 
of  the  flower,  and  then  set  its  age  to  0,  set  the  flower  to  alive,  and  set  its  nectar  to  the  initial 
amount  of  nectar  for  a  flower.  Since  no  nectar  has  been  harvested  yet.  set  that  variable 
correctly,  as  well.  Finally,  figure  out  the  flower’s  lifespan.  Here’s  a  line  of  code  to  help  you: 


lifeSpan 


=  random. Next (LifeSpanMin,  LifeSpanMax  +  1); 

.  — .  .11  L.  _ _ 1/  ■£  \Jrui  v 


This  will  only  work  if  you've  ^your 

variables  and  Constants  "amed  as  well 


Write  code  for  the  HarvestNectar()  method 

Every  time  this  method  is  called,  it  should  check  to  see  if  the  nectar  gathered  every  cycle 
is  larger  than  the  amount  of  nectar  left.  If  so,  return  0.  Otherwise,  you  should  remove 
the  amount  collected  in  a  cycle  from  the  nectar  the  flower  has  left,  and  return  how  much 
nectar  was  collected.  Oh.  and  don’t  forget  to  add  that  amount  to  the  NectarHarvested 
variable,  which  keeps  up  with  the  total  nectar  collected  from  this  particular  flower. 

/ 

We  used  Nectar^atheredPerTum, 
nectar,  and  NectarHarvested  in  this  method, 
but  nothing  else. 


Write  code  for  the  Go()  method 

litis  is  the  method  that  makes  the  flower  go.  Assume  ever)'  time  this  method  is  called,  one 
cycle  passes,  so  update  the  flower’s  age  appropriately  You’ll  also  need  to  see  if  the  age  is 
greater  than  the  flower’s  lifespan.  If  so,  the  flower  dies. 


Assuming  the  flower  stays  alive,  you’ll  need  to  add  the  amount  of  nectar  each  flower  gets 
in  a  cycle.  Be  sure  and  check  against  the  maximum  nectar  your  flower  can  store,  and  don’t 
overrun  that. 


The  -final  product  will  be  animated,  with  little 
pictures  or  bees  flying  around  The  £\o0  method 
will  be  called  once  every  -frame,  and  there  will  be 
several  frames  run  per  second 


Answers  on  the  next  page...  try  and  finish 
your  code  and  compile  it  before  peeking. 
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where  have  all  the  flowers  gone? 


ife; 


RciSe 

Lytton 


Locat'©*'>  Ay> 
Alwe,  Alwe,  and 
Nectar  are 
all  read-only 
automatic- 

properties 


Your  job  was  to  build  the  Flower  class  for  our  beehive  simulator. 

public  class  Flower  { 

private  const  int  LifeSpanMin  =  15000; 

private  const  int  LifeSpanMax  =  30000; 

private  const  double  InitialNectar  =  1.5; 

private  const  double  MaxNectar  =  5.0; 

private  const  double  NectarAddedPerTurn  =  0.01; 

private  const  double  NectarGatheredPerTurn  =  0.3; 

public  Point  Location  {  get;  private  set;  ) 
public  int  Age  {  get;  private  set;  } 
public  bool  Alive  {  get;  private  set;  } 
public  double  Nectar  {  get;  private  set;  } 
public  double  NectarHarvested  {  get;  set;  1 
private  int  lifeSpan; 


Flowers  have  random 
l^espans  so  that 
■fcht  -field  of  flowers 
doesn't  all  change 
exactly  at  onde. 


1 


Flower 


Location:  Point 
Age:  int 
Alive:  bool 
Nectar  double 
NectarHarvested  double 
lifespan:  int 


HarvestNectar():  double 
Go() 


NectarHarvested 

will  need  to  be 
accessible  to  other 
classes. 


public  Flower (Point  location.  Random  random)  { 
Location  =  location; 

Age  =  0; 

Alive  =  true; 

Nectar  =  InitialNectar; 

NectarHarvested  =  0; 
lifeSpan  =  random. Next (LifeSpanMin, 


) 


Nectar) 


M  part  of  the 
simulator's  animation, 
the  ^oO  method  will  be 
called  each  frame  This 
makes  the  f  lower  age 
just  a  tiny  little  bit  per 
frame— as  the  simulator 
runs,  those  tiny  bits  will 
add  up  over  time- 


public  double  HarvestNectar () 
if  (NectarGatheredPerTurn 
return  0; 
else  ( 

Nectar  -=  NectarGatheredPerTurn; 
NectarHarvested  +=  NectarGatheredPerTurn; 
return  NectarGatheredPerTurn; 

) 

) 


LifeSpanMax  +  1); 

A  bee  calls  HarvestNectarO  to  get 
nectar  out  of  a  flower  A  bee  can 
only  harvest  a  little  bit  of  nectar 
at  a  time,  so  he’ll  have  to  sit  near 
the  flower  for  several  turns  until 
the  nectar’s  all  gone 


/Wake  sure  the  flower 
stops  adding  nectar 
after  it’s  dead 


^public  void  Go()  { 

Age++; 

if  (Age  >  lifeSpan) 

Alive  =  false; 
else  { 

Nectar  +=  NectarAddedPerTurn; 
if  (Nectar  >  MaxNectar) 

Nectar  =  MaxNectar; 

) 

I  Point  lives  in  the  System. Drawing  namespace,  so  make  sure  you 

added  using  System.  Dr  awing;  to  the  top  of  the  class  file. 
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Life  and  death  of  a  flower 

Out  flower  goes  through  a  basic  turn,  living,  adding  nectar, 
having  nectar  harvested,  and  eventually  dying: 


age  =  0 


5. -» 


age  =  17809 


As  the  <Wv 

older,  it  ?rodu«s 

more  nettar. 


IhP^>  £K'“t“?lly'  '*11  *»*  otkc 


I 

nitxvt 


Flo\N^ 


9 

■& 


e  i.L  ,  3  »«tar, 

So  ^  tKe  OVM 

"***  ^e  flow*.  hJs 


fcvenWty  *• 

>ciar  =  .C3  I  ao,e  hits  «ts  and 
alive  =  false  ||  the  ^0>wrr 

f  .  J 


age  =  30291 

nectar  =  .83 


tKere.ore  no 

Dumb  Questions 

o* 

It  doesn't  look  like 

NectarHarvested  is  used  anywhere  in 
the  class,  except  where  we  increment  it. 
What's  that  variable  for? 

Good  catch!  We  re  planning  ahead  a 
bit.  Eventually,  the  simulator  will  keep  an 
eye  on  flowers,  and  how  much  total  nectar 
has  been  harvested,  for  our  statistics 
monitor  So  leave  it  in,  and  our  other 
classes  will  use  it  shortly. 

o 

vv^«  Why  all  the  read-only  automatic 
properties? 

Remember  Chapter  5,  and  hiding 
our  privates?  Always  a  good  practice. 
Flowers  can  take  care  of  those  values,  so 
we  ve  made  them  read-only.  Other  objects, 
like  bees  and  the  hive,  should  be  able 
to  read  those  properties,  but  not  change 
them. 

(V 

V^.  My  code  looks  different.  Did  I  do 
something  wrong? 

You  might  have  your  code  in  each 
method  in  a  different  order,  but  as  long 
as  your  code  functions  the  same  way  as 
ours  does,  you'll  be  okay.  That’s  another 
aspect  of  encapsulation:  the  internals 
of  each  class  aren't  important  to  other 
classes,  as  long  as  each  class  does  what 
it's  supposed  to  do. 


If  Go()  increases  the  age  of  the  Flower  by  1,  and  the  lifespan  range  is 
between  15,000  and  30.000.  that  means  Go()  will  get  called  at  least  15.000 
times  for  each  flower  before  it  dies.  How  would  you  handle  calling  the 
method  that  many  times?  What  if  there  are  10  flowers?  100?  1000? 
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busy  bee 


Now  we  wee d  a  Pee  class 


With  (lowers  ready  to  be  harvested,  we  need  a  Bee  class.  Below  is 
the  basic  code  for  Bee.  The  Bee  knows  its  age,  whether  or  not  its 
in  the  hive,  and  how  much  nectar  it  can  collect.  We’ve  also  added  a 
method  to  move  the  bee  towards  a  specific  destination  point. 

public  class  Bee  { 

private  const  double  HoneyConsumed  =  0.5; 
private  const  int  MoveRate  =  3; 
private  const  double  MinimumFlowerNectar 
private  const  int  CareerSpan  =  1000; 


1.5; 


public  int  Age  {  get;  private  set;  } 

public  bool  InsideHive  {  get;  private  set;  } 

public  double  NectarCollected  {  get;  private  set; 

private  Point  location; 

public  Point  Location  {  get  {  return  location;  } 

_ _ Each  bee  will  be  assigned  its  own 

private  int^D;  j  unique  IP  number 

private  Flower  cfestinationFlower; 


<Wanb  ^  „eed  ^  de(  " 

Mn.mumRowerWectar  « 

the  bee  f.gures  out 
•  wh.eh  *lowers  ^e  eligible 
+ov  harvesting. 


) 


We  used  a  backing  -field  -for  location 
If  we  d  used  an  automatic  property, 
/VIoveTowardsLoCationO  wouldn't 
be  able  to  set  its  members  directly 
("Location  *  --  MoveRate”). 


public  Bee (int  id.  Point  location)  { 
this. ID  =  ID; 

Age  =  0; 

this . location  =  location; 
InsideHive  =  true; 
destinationFlower  =  null; 
NectarCollected  =  0; 


public  void  Go (Random  random) 
Age++; 

) 


"  h«ds  an  IP  and 
a*  initial  location. 


Bees  start  out the 

hive,  they  don  t  have  a 
flower  to  y>  to,  and  they 
don’t  have  any  nectar. 


We'll  have  to  add  a  lot 

mre  Code  before 

*eve  done,  but  this  will 
9et  us  started 
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If  the  bee  has ' 

no  des-tirj-tion, 
its  -field  will  be 
set  to  null.  So 
we  only  move 
towards  it  if 
its  destination 
is  HOT  null. 


private  bool  MoveTowardsLocation  (Point  destination)  (and  the  Current 

if  (destination  !g  null!  I _ 

s^i.1  (Math^Abs} destination. X  -  location. X)  <=  MoveRate  && 

>ee  bas  Math. Abs  (destination. Y  -  location. Y)  <=  MoveRate) 

I  return  true; 

II  if  (destination. X  >  location. X) 

location. X  +=  MoveRate;  \ 

move  1 

^  else  if  (destination. X  <  location. X)  ) 

location. X  -=  MoveRate;  /  |f  we're  not  close  enough, 

^11.  if  (destination. Y  >  location. Y)  r  then  we  move  towards  the 

location.  Y  +=  MoveRate;  (  destination  by  our  move  rate 

else  if  (destination. Y  <  location. Y)  \ 
location. Y  -=  MoveRate;  J 


Here  we  used  Math  M>sO  to 
calculate  tbe  absolute  value  of  tbe 
difference  between  tbe  destination 
(and  tbe  Current  location 


P"S  ^tbod  iiirb  by 

+  '3ur,n9  out  .f  we're 
already  witbin  our 

V'R*t  <>(  being  at 
destination. 


return  false; 


We  return  false,  s.^e  we're 

p“"t  m  ««d  t,  keep 


Tbe  /VIoveTowardsLoCationO 
>  ^  destination  moves  tbe  bee  s 


destination  moves  tbe  bee  s 
Current  location  by  Changing 
tbe  y.  and  v  values  of  its 
location  field  It  returns 
true  if  tbe  bee  s  reached  its 
destination 


r  f 


ExeRcvSe 

Bees  have  lots  of  things  they  can  do.  Below  is  a  list.  Create  a  new  enum  that  Bee  uses  called 
BeeState.  You  should  also  create  a  read-only  automatic  property  called  Currentstate 
for  each  Bee  to  track  that  bee  s  state.  Set  a  bee’s  initial  state  to  idle,  and  in  the  Go  ()  method, 
add  a  switch  statement  that  has  an  option  for  each  item  in  the  enum. 

The  enum  item 

What  tbe  item  means 

Idle 

Tbe  bee  isn’t  doing  anything 

FlyingToFlower 

Tbe  bee’s  flying  to  a  flower 

£jatheringNeetar 

Tbe  bee’s  gathering  nectar  from  a  flower 

ReturningToHive 

The  bee’s  beading  back  to  the  hive 

/Vlakingttoney 

The  bee’s  making  honey 

Retired 

Tbe  bee’s  bung  up  bis  wings 
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bee  cool 


EmciSe 

Solution 


Bees  have  lots  of  things  they  can  do.  Below  is  a  list.  Create  a  new  enum  that  Bee  uses 
called  BeeState.  You  should  also  create  a  private  currentstate  field  for  each  Bee  to 
track  that  bee's  state.  Set  a  bee's  initial  state  to  idle,  and  in  the  Go  ( )  method,  add  a  switch 
statement  that  has  an  option  for  each  item  in  the  enum. 


public  enum  BeeState  {  *) 
Idle, 

FlyingToFlower , 
GatheringNectar , 
ReturningToHive , 
MakingHoney , 

Retired 

> 


i 


Here’s  the  em*»  with  dll 
i he  different  bee  states 


public  class  Bee  { 

We  also  need  a  variable  to  track 
tbe  state  W  each  bee 

public  BeeState  Currentstate  {  get;  private  set;  } 


//  constant  declarations 
//  variable  declarations 


public  Bee(int  ID,  Point  InitialLocation)  { 
this. ID  =  ID; 

Age  =0; 

location  =  InitialLocation; 

InsideHive  =  true; 

Currentstate  =  BeeState . Idle;  ^ 

destinationFlower  =  null;  The  bee  start*  out  idle- 

NectarCollected  =  0; 


Did  you  remember  to  add  using  System.  Drawing;  to  the  top  of  the 
class  file  (because  it  uses  Point)? 
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public  void  Go (Random  random) 
Age++;  ^  _ 

switch  (CurrentState)  { 
case  BeeState . Idle : 

if  (Age  >  CareerSpan) 


SSi*  t*“Lari^h0  t, 

Mhdle  each  bee's  s^. 


We’ve  -filled  out  a  few 
of  the  states.  It's  okay 
if  you  didn't  £o*»e  up 
with  this  Code,  but  50 
ahead  and  add  it  in  now 


{ 


CurrentState  =  BeeState. Retiree 
else  { 

//  What  do  we  do  if  we're  idle? 


If  the  a*e  reaches  the  bee's  lifespan, 
Current  job  before  he  does 


break; 

case  BeeState . FlyingToFlower : 

//  move  towards  the  flower  we're  heading  to 
break; 

case  BeeState . GatheringNectar :  , 

double  nectar  =  destinationFlower.HarvestNectar ()  , 

if  (nectar  >  0)  ^ _ and  if  there's  nectar 

NectarCollected  +=  nectar;  <£7 —  left,  add  it  to  what 

we've  already  Collected... 


**»  fill  this 
a  bit  later. 


in 


Here,  we  harvest 
nectar  fronr.  the 
flower  we're  working 


but  if  there's  no  nectar 
left,  head  for  the  hive 


You  should  have  else 

each  of  these  CurrentState  =  BeeState. ReturningToHive; 

states  Covered  break; 

case  BeeState. ReturningToHive: 

if  (UnsideHive)  {  ^ ^  to  the  h.ve  is 

//  move  towards  the  hive  different  based  on  whether 

I  else  {  we're  already  in  the  hive 


//  what  do  we  do  if  we're  inside  the  hive? 


or  not- 


)  break; 

case  BeeState .MakingHoney: 

if  (NectarCollected  <0.5)  ( 
NectarCollected  =  0; 
CurrentState  =  BeeState. Idle; 
}  else  { 


The  bee  adds  half  a 
nectar  to  the  honey  factory 

at  a  time.  If  * 
enough  nectar  to  add,  the 
factory  can’t  *se  it  *>  the 
bee  j«st  discards  it- 


//  once  we  have  a  Hive,  we' 11  turn  the  nectar  into  honey 


) 


break; 

case  BeeState . Retired: 

//  Do  nothing!  We're  retired! 
break; 


} 


I 


you  are  here  ► 


527 


beehive  hairdo 


P.  A.  H.  P.  (Programmers  Against  Homeless  Pees) 

We’ve  got  bees,  and  flowers  full  of  nectar.  We  need  to  write  code  so 
the  bees  can  collect  nectar,  but  before  that  happens,  where  do  the 
bees  get  created  in  the  first  place?  And  where  do  they  take  all  that 
nectar?  That’s  where  a  Hive  class  conies  in. 

The  hive  isn't  just  a  place  for  bees  to  come  back  to,  though.  It  has 
several  locations  within  it,  all  with  different  points  in  the  world. 

There’s  the  entrance  and  the  exit,  as  well  as  a  nursery  for  birthing 
more  bees  and  a  honey  factory  for  turning  nectar  into  honey. 


The  Hive 


£adh  location  is  distinct 
and  bees  can  travel  fro*, 
one  to  the  other  just  like 
they  Can  ^o  from  the  hive 
to  a  flower 


ffew  bees  are 
treated  and 
start  out  in  the 

Kwe  nursery 


Bees  Cone  in  the  entrance, 
and  leave  from  the  exit,  ft's 
all  very  orderly. 


The  hive  runs  on  honey 


The  other  big  part  that  the  hive  plays  is  keeping  up  with  how  much 
honey  it  has  stored  up.  It  lakes  honey  for  the  hive  to  keep  running, 
and  if  new  bees  need  to  be  created,  that  takes  honey,  too.  On  top 
of  that,  the  honey  factory  has  to  take  nectar  that  bees  collect  and 
turn  that  into  honey.  H>r  even1  unit  of  nectar  that  comes  in,  .25 
units  of  honey  can  be  created.  _ _ ^ 


Think  about  this  (or  a  second  as  time 
passes,  the  hive  uses  honey  to  run,  and  to 
Create  more  bees  Meanwhile,  other  bees 
are  br.n5.n5  in  nectar,  which  5ets  turned 
into  honey,  which  keeps  thin5s  5^5  lon5er 

It's  up  to  you  (with  some  help)  to  model  all 
of  this  in  the  simulator  Code 
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It’s  up  to  you  to  write  the  code  for  Hive. 


O 


o 


o 


Write  the  skeleton  code  for  Hive 

Like  we  did  with  the  Flower  class,  you  should  start  with 
a  basic  skeleton  for  Hive.  The  class  diagram  is  shown  to 
the  right.  Make  die  Honey  a  read-only  automatic  property 
locations  should  be  private,  and  beeCount  is  only 
used  internally,  so  can  be  a  private  field. 


Define  the  constants  for  the  Hive 

You  need  a  constant  for  the  initial  number  of  bees  (6),  the  amount 
of  honey  the  hive  starts  with  (3.2),  the  maximum  amount  of  honey 
die  hive  can  store  (15),  and  ratio  of  units  of  nectar  produced  from 
units  of  honey  (.25),  the  maximum  number  of  bees  (8),  and  the 
minimum  honey  required  for  the  hiv  e  to  birth  new  bees  (4). 


Write  the  code  to  work  with  Locations 

First,  write  the  Get  Location  ( )  method.  It  should  take  in  a 
string,  look  up  that  string  in  the  Locations  dictionary;  and  return 
the  associated  point.  If  it's  not  there,  throw  an  ArgumentExcepdon. 


_ Hive _ 

Honey:  double 

locations:  Dictionary<string.  Point> 
beeCount:  int 

lnitializeLocations() 

AddHoney(Nectar:  double):  bool 
ConsumeHoney(amount:  double):  bool 
AddBee(random:  Random) 

Go( random:  Random) 
getLocation( location:  string):  Point 


/II  have  to  out  V*  "f**  U 
eh.  as  well  as  -the  tyres.  For  tyyes, 

**t  think  about  values,  but 

so  the  values  these  co^ts  Will  be 

ed  with  Doubles  fair  best  w.th  other 
oubles,  mts  with  other  mts 


Then,  write  the  InitializeLocations  ( )  method.  This 
method  should  set  up  the  following  locations  in  the  hive: 


♦ 


♦ 


♦ 


♦ 


Entrance,  at  (600,  100) 
Nursery,  at  (95.  1 74) 
Honey  Factory,  at  (157,  98) 
Exit,  at  (1 94,  213) 


Each  of  these  maps  to  a  location 
that  our  hive 

takes  up.  Later  on,  we'll  have  to 
".ake  sure  the  simulator  makes  the 
h.ve  cover  all  these  points. 


Build  the  Hive  constructor 

W  hen  a  hive  is  constructed,  it  should  set  its  honey  to  the  initial 
amount  of  honey  all  hives  have.  It  should  setup  the  locations 
in  the  hive,  and  also  create  a  new  instance  of  Random.  Then, 
AddBee  ( )  should  be  called — passing  in  the  Random  instance  you 
just  created — once  for  each  bee  that  stru  ts  out  in  the  hive. 


tion,  were 
hive,  "Ah  to* 
,  varied 
make  the 


i&eeO  needs  a  Random  object  because  A  adds 

andom  value  to  the  Nursery  location-that  way 

.  bees  don't  start  on  top  each  other 
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529 


first  design  then  build 


h 


Your  job  was  to  start  building  the  Hive  class. 

Ex^RCtSC  Make  sure  you  add  'using  System. 

Qai.  Drawing;"  because  this  Code  uses  You  might  hav< 

Solution  Poi„t  I  c^i 

public  class  Hive  l  ^ 

private  const  int  InitialBees  =  6;  V***  Cl 

private  const  double  InitialHoney  =  3.2;  ^  _ . 

private  const  double  MaximumHoney  =  15.0; 
private  const  double  NectarHoneyRatio  =  .25; 
private  const  double  MinimumHoneyForCreatingBees  =  4.0; 
private  const  int  MaximumBees  =  8; 


private  Dictionary<string,  Point>  locations; 
private  int  beeCount  =  0;  _ 

public  double  Honey  {  get;  private  set;  } 


private  void  InitializeLocations ()  {  ' 

locations  =  new  Dictionary<string,  Point>(); 
locations. Add ("Entrance",  new  Point (600,  100)); 

locations .Add ("Nursery",  new  Point(95,  174));  « - 

locations .Add ("HoneyFactory" ,  new  Point(157,  98)); 
locations .Add ("Exit",  new  Point (194,  213));  ^ 


f*  ^  drfUt  names 
i  V**  That's  okay, 

*  H*  '?*'*  *°«'stent  in  the 
r^st  o+  your  Code 

_ VVe  made  AlanimumHoney 

a  double,  since  it  can 
range  -from  InitialHoney 
ees  =  4.0;  CI-7J  to  this  value  Smde 
InitialHoney  will  need  to 
be  a  double,  it's  best  to 
make  this  a  double,  too 

ktH  a  >jW 


i.atarf*  D,lW^ 


or  this  won 


t  wovk 


public  Point  GetLocation (string  location)  {  ^ 

if  (locations .Keys .Contains (location) ) 
return  locations [location] ; 
else 

throw  new  ArgumentException ("Unknown  location: 


of  this 
method  is  pretty 

straight-forward 


public  Hive ( )  (  and  t 

Honey  =  InitialHoney;  |t's  a 

InitializeLocations () ; 

Random  random  =  new  Random ( ) ; 


A  This  method  protects  other  classes' from 
V  working  With  our  locations  d.tt-onary 
and  Changing  something  they  shouldnt. 
It's  an  example  of  encapsulation 


location) ; 


- -  _ - - - —  w  '  ,,  v>avf  taueo 

for  (int  i  =  0;  i  <  InitialBees;  i++)  you  sh««  r  eath  bee 

.  j_it» , _ i i  .  . —  _ —  £^aaRec()  onCe 


AddBee (random) ; 


Ikal  a  ^ 


public  bool  AddHoney (double  Nectar)  (  return  true;  } 
public  bool  ConsumeHoney (double  Amount)  (  return  true;  } 
private  void  AddBee (Random  random)  {  ) 
public  void  Go (Random  random)  {  } 


We  don’t  have  Code 
for  these  yet,  but 
you  should  have  built 
empty  methods  as 
placeholders. 
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Isn't  this  sort  of  a  weird  way 
to  build  code?  Our  bees  don't  know  about 
flowers  yet,  and  our  hive  is  full  of  empty 
method  declarations.  Nothing  actually  works 
yet,  right? 


Real  code  is  built  bit  by  bit 

It  would  be  nice  if  you  could  write  all  die  code  for  a  single 
class  at  one  time,  compile  it,  test  it,  and  put  it  away,  and 
then  start  on  your  next  class.  Unfortunately,  that’s  almost 
nev  er  possible. 

More  often  than  not,  you'll  write  code  just  die  way  we  are 
in  this  chapter:  piece  by  piece.  We  were  able  to  build  pretty 
much  the  entire  Flower  class,  but  when  it  came  to  Bee, 
we’ve  still  got  some  work  to  do  (mostly  telling  it  what  to  do 
for  each  state). 

And  now,  with  Hive,  we’ve  got  lots  of  empty  methods  to 
fill  in.  Plus,  we  haven’t  hooked  any  Bees  up  to  the  Hive. 
And  there’s  still  that  nagging  problem  about  how  to  call  the 
Go  ( )  method  in  all  these  objects  thousands  of  times... 


But  we  didn't  really  start  out 
by  putting  the  classes  together!  We 
figured  out  the  architecture  f irst, 
and  then  started  building. 


0 


First  you  design,  then  you  build 

We  started  out  the  project  knowing  exactly  what  we 
wanted  to  build:  a  beehive  simulator.  And  we  know 
a  lot  about  how  the  bees,  (lowers,  hive,  and  world  all 
worked  together.  That’s  why  we  stin  ted  out  with  the 
architecture,  which  told  us  how  the  classes  would  work 
with  each  other.  Then  we  could  move  onto  each  class, 
designing  them  individually. 

Projects  always  go  a  lot  more  smoothly  if  you  have  a  good 
idea  of  what  you’re  building  before  you  start  building  it. 
That  seems  pretty  straightforward  and  common-sense.  But 
it  makes  all  the  difference  in  the  final  product. 


you  are  here  * 
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make  the  hive  Go() 


Filling  out  the  Hive  class 

Let’s  get  hark  to  the  Hive  class,  and  till  in  a  few  of 
those  missing  methods: 

public  class  Hive  { 

//  constant  declarations 
//  variable  declarations 


// 

// 

// 


InitializeLocations () 
GetLocation ( ) 

Hive  constructor 


we  U 

(  be  converted 

public  bool  AddHoney (double  nectar)  (  \T, 

double  honeyToAdd  =  nectar  *  NectarHoneyRatio;  ^*en  iee  'f  'there's 

if  (honeyToAdd  +  Honey  >  MaximumHoney)  - - - ^lve  that 

return  false;  (  ""*CK  ",ore  Ko^ 

Honey  +=  honeyToAdd;  - -  l£  there  s  room,  we  add  the 

return  true;  honey  to  the  hive- 

}  ^ - __  This  method  takes  an  amount .of 

public  bool  ConsumeHoney  (double  amount)  {  honey,  and  tries  to  Consume  it 
if  (amount  >  Honey)  from  the  hive s  stores 

return  false;  |{  there’s  not  enough  honey  in  the  hive 

else  {  to  meet  the  demand,  we  return  false 

Honey  —  amount;  4—f 

return  true;  |£  there’s  enough,  remove  it  £rom  the 

}  hive's  stores  and  return  true- 


} 

private  void  AddBee (Random  random) 
beeCount++; 

int  rl  =  random. Next (100)  -  50; 
int  r2  =  random. Next (100)  -  50; 

Point  startPoint  =  new  Point (locations ["Nursery"] 

locations ["Nursery" ] 

Bee  newBee  =  new  Bee (beeCount,  startPoint);  _ _ 

/ /  Once  we  have  a  system,  we  need  to  add 


This  creates  a  point  within 
50  units  in  both  the  X 
and  V  direction  from  the 
nursery  location 


Add  a  new 
tee,  at  the 
designated 

_  _  location. 

this  bee  to  the  system 


.X 

.Y 


rl, 

r2) 


} 

public  void  Go (Random  random)  {  } 


We’ll  finish  AddBeeO  and  Wl 

the  $o()  method  soon.  • 


532  Chapter  12 


review  and  preview 


The  hive's  6-ot)  method 


We’ve  already  written  a  Go  ( )  method  for  Flower,  and  a  Go  ( ) 
method  for  Bee  (even  though  we’ve  got  some  additional  code  to 
add  in).  Here’s  the  Go  ( )  method  for  Hive: 

public  void  Go (Random  random)  { 


TKe  «Jy  Constraint  ,  ,  c 

*  tte  hive  l  ,  **  *  w  *ow) 


if  (Honey  >  MinimumHoneyForCreatingBees) 


} 


AddBee (random) ; 


The  same  instance  of  Random  that 
got  passed  -to  fyO  yb  sen!  b  "the 
AddBeeO  method 


Unfortunately,  this  isn’t  wry  realistic.  Lots  of  times  in  a  busy 
hive,  the  queen  doesn’t  have  time  to  create  more  bees.  We  don’t 
have  a  QueenBee  class,  hut  let’s  assume  that  when  there’s 
enough  honey  to  create  bees,  a  new  bee  actually  gets  created 
10%  of  the  time.  We  can  model  that  like  this: 


public  void  Go (Random  random)  { 


if  (Honey  >  MinimumHoneyForCreatingBees 


&&  random. Next (10)  ==  1) 

AddBee (random) ; 


{ 


This  is  an  easy  ^  J  . 

10  thante  of  a  be  ytbn$  treated. 

|t  tomes  U?  with  a  random  number 
between  0  and  %  ihe  number 

then  Create  the  bee 


O: 


_  So  the  hive  can  create  an  infinite 
number  of  bees? 


A: 


Right  now  it  can— or,  at  least,  it’s  got 
a  very  large  limit— but  you’re  right,  that’s  not 
very  realistic.  Later  on,  we  ll  come  back  to 
this,  and  add  a  constraint  that  only  lets  so 
many  bees  exist  in  our  simulator  world  at 
one  time. 


tl lerejore  no 

Dumb  Questions 


o* 

Couldn't  we  assign  that  instance 
of  Random  to  a  property  of  the  class, 
instead  of  passing  it  on  to  AddBeeO? 

You  sure  could  Then  AddBee  could 
use  that  property,  rather  than  a  parameter 
passed  in.  There’s  not  really  a  right  answer 
to  this  one;  it’s  up  to  you. 


/ 


One  reason  to  leave  if  out  j$  that  you 
(■a*  save  the  Random  seed-that  way 
you  tan  re-run  a  specie  simulation,  if 
you  feel  like  doing  that  later/ 


O: 


_  I  still  don’t  understand  how  all  of 
these  Go()  methods  are  getting  called. 


A: 


That's  okay,  we  re  just  about  to  get  to 
that.  First,  though,  we  need  one  more  object; 
the  World  class,  which  will  keep  track  of 
everything  that’s  going  on  in  the  hive,  track 
all  the  bees,  and  even  keep  up  with  flowers. 
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take  on  the  world 


We're  ready  for  the  World 


With  a  Hive,  Bee,  and  Flower  class  in  place,  we  can 
finally  build  the  World  class.  World  handles  coordination 
between  all  the  individual  pieces  of  our  simulaor:  keeping 
up  with  all  the  bees,  telling  the  hive  if  there  is  room  for 
more  bees,  locating  flowers,  etc.: 


»r  witt  ^ 


World  is 

a  W  and 

,  c  r  all  the 

erA"*  wr  ” 

T  .  »  -1 


The  World  object  keeps  everything  Go  ( )  mg 


We  doh't  kave 
<*11  the  Code  for 

these  classes 
witten,  but  we've 
3°t  the  basic 
P^ts  in  place. 


$°0  in  World  Calls  $o0  on  all 
the  other  objects  in  the  world 


E 


foreach  (Flower  flower  in  Flowers) 
flower . Go ( random) ; 


foreach  (Bee  bee  in  Bees) 
bee . Go (random) ; 


Main  form 


hive . Go ( random) ; 


System  WV 


We  still  Mee  to  deal  witt 
calling  World's  6\o0  method, 
but  we’ll  Come  back  to  that 


One  of  the  biggest  tasks  of  the  World  object  is,  for  each  turn  in 
the  simulator,  to  rail  Go  ( )  on  every  Flower,  Bee,  and  Hive 
instance.  In  other  words.  World  makes  sure  that  life  continues 
in  the  simulator  world. 
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We're  building  a  turn-based  system 

Our  Go  ( )  methods  in  each  object  are  supposed  to  run  each  turn,  or  cycle,  of  our 
simulator.  A  turn  in  this  case  just  means  an  arbitrary  amount  of  time...  for  instance,  a 
turn  could  be  every  10  seconds,  or  every  60  seconds,  or  every  10  minutes. 


Each  “-turn”  will  be  drawn 


as  a  single  -frame  of 
animation,  so  the  world 


The  main  thing  is  that  a  turn  affects  every  object  in  the  world.  The  hive  ages  by  one 
“turn”,  checking  to  see  if  it  needs  to  add  more  bees.  Then  each  bee  takes  a  turn,  moving 


only  needs  to  change  a 
tiny  litle  bit  each  -burn. 


a  very  small  distance  towards  its  destination  or  doing  one  small  action,  and  getting  older. 


Then  each  flower  takes  a  turn,  manufacturing  a  little  nectar  and  getting  older  too.  .And 


that's  what  World  does:  it  makes  sure  that  every  time  its  Go  ( )  method  is  called,  every 


object  in  the  world  gets  a  turn  to  act 


Flower 


Flower 


Flower 
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what  in  the  world  are  you  doing? 


Here's  the  code  for  World 

Hie  World  class  is  actually  one  of  the  simpler  classes  in  our 
simulator.  Here’s  the  code: 


using  System. Drawing; 
public  class  World  { 

private  const  double 


NectarHarvest 


private  const  int  FieldMinX 
private  const  int  FieldMinY 
private  const  int  FieldMaxX 
private  const  int  FieldMaxY 


PerNewFlower  =  50.0; 

These  define  the  bounds  of-  the 
■field,  which  is  where  -flowers  can  live. 


public  Hive  Hive; 
public  List<Bee>  Bees; 
public  List<Flower>  Flowers; 


_  Bvery  world  has  one  hive,  a  l*t 

—  of  bees,  and  a  list  of  lowers. 


public  World ()  { 

Bees  =  new  List<Bee>(); 
Flowers  =  new  List<Flower> ( ) 
Random  random  =  new  Random ( ) 
for  (int  i  =  0;  i  <  10;  i++) 
AddFlower (random) ; 

) 


When  we  create  a  *ew  *»\d,  * 
initial  our  lists,  create  a  new  h,ve, 

and  then  add  10 


public  void  Go  (Random  random)  {  wejust  tell  the  Hive 

Hive. Go  (random) ;  <  - - '  ^  '  Passih9  a  Random  instance 


for 


(int  i  =  Bees. Count  - 
Bee  bee  =  Bees[i]; 
bee . Go ( random) ; 
if  (bee .CurrentState  == 
Bees .Remove (bee) ; 


ft*  thresh  all  the  Current 
bees  and  tell  them  6\cO. 

b«’s  retired,  we  need  to  take 
Tout  of  the  world- 


1 


double  totalNectarHarvested  =  0; 
for  (int  i  =  Flowers . Count  -  1;  i  >=  0; 
Flower  flower  =  Flowers [ij;  — 

flower .Go ( ) ; 

totalNectarHarvested  +=  f lower. Necti 
if  (! flower .Alive) 

Flowers .Remove (flower) 


i— ) 


We  run  through  each  flower 
*"d  tell  it  to  6oO. 

IS 


l 


arvested; 


lil" ttt!-  •«  >■««<»,  j«v  a: _ 

tort  a 


We  need  to  keep  up  with 
how  much  nectar's  been 
Collected  this  turn,  too 
So  we  get  that  by  summing 
up  the  nectar  Collected 
from  each  flower 
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Solution 


Wert  are  lWe  **  Un't 
with  Did  y°u  tome  u? 
with  ar>Y  others? 

Hive 

1.  Tbe  Kive's  Lodations 
diC.'tionary  is  privd'te 

2.  It  ogives  the  bees  a 
method  to  add  honey 


One  of  the  big  object-oriented  principles  we've  been  using  in  the  simulator 
is  encapsulation  (flip  back  to  Chapter  5  for  a  refresher).  See  if  you  can  look 
over  the  code  we've  developed  so  far  and  come  up  with  two  examples  of 
encapsulation  for  each  class  you've  built. 


Bee 

1 .  The  bee  s  lodation  is 
read-only 

2.  £0  is  its  a^e  £0  other 
dlasses  dan  t  write  to  them 


Flower 

1 .  The  -flower  provides  a 
method  to  gather  nedtar 

2.  And  it  keeps  its  alive 
boolean  private 


if  (totalNectarHarvested  >  NectarHarvestedPerNewFlower)  { 

foreach  (Flower  flower  in  Flowers)  es {lowers  as  they  harvest 

flower  .NectarHarvested  =  0;  e  ,  J  ^ iu.u'u,  karwsted  enough 

AddFlo^fer ( random) ; 


} 


net-tar.  Orte  they've  harvested  enov^h 
nee-tar  from  the  powers,  they  ve 
l-P  there's  enough  nedtar  in  the  -field,  polluted  enough  for  the  wor  d  to  a 

true,  the  world  adds  a  new  flower.  new  flower 


private  void  AddFlower (Random  random) 

{ 

Point  location  =  new  Point (random. Next (FieldMinX,  FieldMaxX) , 

random. Next (FieldMinY,  FieldMaxY) ) ; 
Flower  newFlower  =  new  Flower (location,  r|^dom) ; 

Flowers  .Add  (newFlower) ;  handles  Coming  uf  with  a  random 

location  in  the  field- 


and  then  adding  a  new 
flower  in  that  location- 


tbere,ore  no 

Dumb  Questions 


Q„:  Why  don't  you  use  foreach  loops  to 
remove  dead  flowers  and  retired  bees? 

Because  you  can't  remove  items  from 
a  collection  from  inside  a  foreach  loop  that’s 
iterating  on  it.  If  you  do,  NET  will  throw  an 
exception. 


Qj  Okay,  then  why  does  each  of  those 
for  loops  start  at  the  end  of  the  list  and 
count  down  to  0? 

Because  each  loop  needs  to  preserve 
the  numbering  of  the  list.  Let’s  say  you 
started  at  the  beginning  of  a  list  of  five  bees, 
and  your  loop  discovered  that  one  of  the 
flowers  in  the  middle  was  dead.  If  it  removes 


the  flower  at  index  #3,  now  the  list  only  has 
4  flowers  in  it,  and  there's  a  new  flower  at 
index  #3— and  that  flower  will  end  up  getting 
skipped,  because  the  next  time  through  the 
loop  it'll  look  at  index  #4. 

If  the  loop  starts  at  the  end,  then  the  flower 
that  moves  into  the  empty  slot  will  already 
have  been  looked  at  by  the  loop,  so  there's 
no  chance  of  missing  a  flower. 
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put  it  all  together 


With  all  four  of  our  core  classes  in  place,  we've  got  some  work  to  do  to  tie  them  all 
together.  Follow  the  steps  below,  and  you  should  have  working  Bee,  Hive,  Flower,  and 
World  classes.  But  beware:  you'll  have  to  make  changes  to  almost  every  class,  in  several 
places,  before  you're  done. 


Update  Bee  to  take  in  a  Hive  and  World  reference. 

Now  that  we've  got  a  class  for  Hive  and  a  class  for  World,  Bee  objects  need  to 
know  about  both.  Update  your  code  to  take  in  references  to  a  bee's  hive  and  world  in 
the  constructor  and  save  those  references  for  later  use 


Update  Hive  to  take  in  a  World  reference. 

Just  as  a  Bee  needs  to  know  about  its  Hive,  a  Hive  needs  to  know  about  its 
World.  Update  Hive  to  take  in  a  World  reference  in  its  constructor,  and  save  that 
reference.  You  should  also  update  the  code  in  Hive  that  creates  new  bees  to  pass 
into  the  Bee  a  reference  to  itself  (the  Hive),  and  the  World. 


Update  World  to  pass  itself  into  a  new  Hive. 

Update  your  World  class  so  that  when  it  creates  a  new  Hive,  it 
passes  in  a  reference  to  itself. 


STOP!  At  this  point,  jou  should  l>c  al>le  to  compile  all  of 
your  code.  If  you  can't,  check  through  it  and  correct  any 
mistakes  before  continuing  on. 


Place  an  upper  limit  on  the  bees  that  Hive  can  create. 

The  Hive  class  has  a  MaximumBees  constant  that  determines 
how  many  bees  the  Hive  can  support  (inside  and  outside  the  hive, 
combined).  Now  that  the  Hive  has  access  to  the  World,  you  should  be 
able  to  enforce  that  constraint. 


When  the  Hive  creates  bees,  let  the  World  know. 

The  World  class  keeps  up  with  all  the  bees  that  exist.  When  the  Hive 
creates  a  new  Bee.  make  sure  that  Bee  gets  added  to  the  overall  list 
that  the  World  is  keeping  up  with 


*7j!?,Pb£'‘  *>*r' 
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Dumb  Questions 


Oj 

Why  did  you  throw  an  exception  in  the  Hive  class’s 
GetLocation()  method? 

Because  we  needed  a  way  to  deal  with  bad  data  passed  into 
the  parameter.  The  hive  has  a  few  locations,  but  the  parameter  to 
GetLocationsQ  can  pass  any  string  What  happens  if  there's  a  bug  in 
the  program  that  causes  an  invalid  string  (like  an  empty  string,  or  the 
name  of  a  location  that’s  not  in  the  locations  dictionary)  to  be  sent  as 
the  parameter?  What  should  the  method  return? 

When  you've  got  an  invalid  parameter  and  it's  not  clear  what  to  do 
with  it,  it's  always  a  good  idea  to  throw  a  new  ArgumentException. 
Here  s  how  the  GetLocation()  method  does  it: 

throw  new  ArgumentException ( 

"Unknown  location:  "  +  location); 

This  statement  causes  the  Hive  class  to  throw  an  ArgumentException 
with  the  message  ‘Unknown  location:”  that  contains  the  location  that 
it  couldn’t  find. 


/\*  Every  bee  has  a  location,  whether  or  not  you  draw  it  on  the 
screen  in  that  location.  The  job  of  the  Bee  object  is  to  keep  track 
of  where  it  is  in  the  world.  Each  time  its  Go  ( )  method  is  called,  it 
needs  to  move  a  very  small  distance  towards  its  destination. 

Now,  even  though  we  may  not  be  drawing  a  picture  of  the  bee  yet, 
the  bee  still  needs  to  keep  track  of  where  it  is  inside  the  hive  or  in  the 
field,  because  it  needs  to  know  if  it's  arrived  at  its  destination, 

o 

vq<;  Then  why  use  Point  to  store  the  location,  and  not 
something  else?  Aren't  Point  s  specifically  for  drawing? 

J\‘.  Yes,  a  Point  is  what  all  of  the  visual  controls  use  for  their 
Location  properties.  However,  just  becase  NET  uses  them  that  way, 
that  doesn't  mean  it’s  not  also  useful  for  us  to  keep  track  of  locations. 
Yes,  we  could  have  created  our  own  BeeLocation  class  with 
integer  fields  called  X  and  Y.  No  reason  reinvent  the  wheel  when  C# 
and  NET  give  us  Point  for  free! 


The  reason  this  is  useful  is  that  it  immediately  alerts  you  if  a  bad 
location  parameter  is  passed  to  the  method.  And  by  including  the 
parameter  in  the  exception  message,  you’re  giving  yourself  a  some 
valuable  information  that  will  help  you  debug  the  problem. 

Qj  What's  the  point  of  storing  all  the  locations  in  a  Point 
object  if  we  re  not  drawing  anything? 


It’s  almost  always  easier  to 
repurpose  or  extend  an  existing 
class  tkat  does  MOSTLY  vkat  you 
want  it  to  do,  ratker  tkan  creating 
an  all  new  class  Jrom  scratck. 
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exercise  solution 


ExendSe 

§0(.ytl0H 


With  all  four  of  our  core  classes  in  place,  we've  got  some  work  to  do  to  tie  them  all 
together.  Follow  the  steps  below,  and  you  should  have  working  Bee,  Hive,  Flower,  and 
World  classes.  Here’s  how  we  made  the  changes  to  put  this  into  place. 


Update  Bee  to  take  in  a  Hive  and  World  reference. 

Now  that  we've  got  a  class  for  Hive  and  a  class  for  World,  Bee  objects  need  to 
know  about  both.  Update  your  code  to  take  in  references  to  a  bee's  hive  and  world  in 
the  constructor  and  save  those  references  for  later  use. 


public  class  Bee  { 

//  existing  constant  declarations 
//  existing  variable  declarations 

private  World  world; 
private  Hive  hive; 


public  Beefint  ID,  Point 
//  existing  code 

this. world  =  world; 
this. hive  =  hive; 


InitialLocation,  World  world,  Hive  hive)  ( 

TV*  is  jretfc/  straightforward-  take 
these  in,  assign  the-  to  ''*r,ables 


Update  Hive  to  take  in  a  World  reference. 

Just  as  a  Bee  needs  to  know  about  its  Hive,  a  Hive  needs  to  know  about  its 
World.  Update  Hive  to  take  in  a  World  reference  in  its  constructor,  and  save  that 
reference.  You  should  also  update  the  code  in  Hive  that  creates  new  bees  to  pass 
into  the  Bee  a  reference  to  itself  (the  Hive),  and  the  World. 


public  class  Hive  { 


private  World  world;  ^ _  More  basic  code  .,  yt  the 

assign  it  locally. 

public  Hive  (World  world)  {  '  V°u  want  to  assign  the 

this. world  -  world;  world  because  the 

//  existing  code  the  Constructor 

i  weeds  -fco  use  it- 


New  bees  need  a 
reference  to  the  world, 
and  to  the  w.ve,  now. 


public  void  AddBee (Random  random)  ( 

//  other  bee  creation  code 

Bee  newBee  =  new  Bee (beeCount,  startPoint, 


world,  this); 
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If  you’re  having  trouble  getting  this  running,  you  can  download  the 
code  for  this  exercise  (and  all  the  others,  too)  from  http://wwv. 
headfirstlahs.com/hooks/hfcsharp/ 


Update  World  to  pass  itself  into  a  new  Hive. 

Update  your  World  class  so  that  when  it  creates  a  new  Hive,  it 
passes  in  a  reference  to  itself. 

public  World ()  { 

Bees  =  new  List<Bee>(); 

Flowers  =  new  List<Flower> ( ) ; 

Hive  =  new  Hive  (this);  - 

Random  random  =  new  Random ( ) ; 
for  (int  i  =  0;  i  <  10;  i++) 
AddFlower (random) ; 


this  passes  <1 

to  the  tt'we- 


the  re&renCe 


Place  an  upper  limit  on  the  bees  that  Hive  can  create. 

The  Hive  class  has  a  MaximumBees  constant  that  determines 
how  many  bees  the  Hive  can  support  (inside  and  outside  the  hive, 
combined).  Now  that  the  Hive  has  access  to  the  World,  you  should  be 
able  to  enforce  that  constraint. 

public  void  Go  (Random  random)  { 

if  (world.  Bees  .  Count  <  MaximumBees  *= 

&  f.  Honey  >  MinimumHoneyForCreatingBees 


&&  random. Next (10) 
AddBee (random) ; 


We  can  use  the  World 
object  to  see  how  mjny 
■total  bees  there  are,  and 
Compare  that  to  the 
maximum  bees  (or  this  hive. 

son  M  I*  Ws  no 


We  put  that  Common  *«rST  n  - 

-for  bees,  no  sense  .»  *  the 


,^h  honey  to  create  bees 


When  the  Hive  creates  bees,  let  the  World  know. 

The  World  class  keeps  up  with  all  the  bees  that  exist.  When  the  Hive 
creates  a  new  Bee.  make  sure  that  Bee  gets  added  to  the  overall  list 
that  the  World  is  keeping  up  with. 

private  void  AddBee ( Random  random)  { 
beeCount++; 

//  Calculate  the  starting  point 

Point  startPoint  =11  start  the  near  the  nursery 

Bee  newBee  =  new  Bee (beeCount,  startPoint,  world,  this); 

world . Bees .Add (newBee) ;  ^ _ 

c 

^ _ Wfe  add  the  new  bee  to  the  This  demonstrates  one  <*  ( 


Terence  in  the  ttive  class. 
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make  the  bees  behave  themselves 


(riving  the  bees  behavior 

The  one  big  piece  of  code  that’s  missing  in  our  current  classes 
is  the  Bee’s  Go  ( )  method.  YVe  were  able  to  code  a  few  of 
the  states  earlier,  but  there  are  plenty  left  (Idle  is  incomplete, 
FlyingToFlower,  and  part  of  MakingHoney). 


Let’s  finish  up  those  remaining  states  now: 


public  void  Go (Random  random) 
Age++; 

switch  (CurrentState)  { 
case  BeeState. Idle: 


{ 


|f  *e’re  .die-  we  to 
'  flower  to  harvest 


pother 


{ 


Assuming  that  all 
Wrtrb  ovi  goto  the 
*ew  flower 


if  (Age  >  CareerSpan) 

CurrentState  =  BeeState . Retired; 

else  if  (world. Flowers .Count  >  0 

&&  hive . ConsumeHoney (HoneyConsumed) ) 

Flower  flower  = 

world . Flowers [ random . Next (world . Flowers . Count) ] ; 
f  (flower . Nectar  >=  MinimumFlowerNectar  &&  flower .Alive)  { 
destinationFlower  =  flower; 

CurrentState  =  BeeState. FlyingToFlower; 

} 


See  if  there  are  flowers  left,  and 
then  Consume  enough  honey  to  keep 
going.  Otherwise,  weVe  stuck. 

We  need  another 
/  living  flower  with 
^  £  necir. 


or> 


f 


} 


break  •  Make  sure  the  f lower  hasn't 

case  BeeState .  FlyingToFlower :  d,ed  as  weVe  Ke*M  *****  '*• 

if  ( ! world . Flowers . Contains (destinationFlower) )  < - } 

CurrentState  =  BeeState . Re turningToHive ; 
else  if  (InsideHive)  { 


That's  why  we  passed  a 
reference  to  the  hive ' 
to  the  Bee  Constructor. 


if  (MoveTowardsLocation (hive . GetLocation ("Exit") ) )  { 
InsideHive  =  false; 

location  =  hive . GetLocation ( "Entrance" ) ;  f 

|f  we  can  get  to  the  then  we 

Update  our  location.  Since  were  now 
*e  should  fly  out  near  the  entrance, 
if  (MoveTowardsLocation (destinationFlower . Location) ) 


re  out  of  the  hive- 
on  the  field  form, 


CurrentState  =  BeeState . GatheringNectar ;  . 

If  weWoutof 
the  hive,  and  the 

flower  js  a|ive> 

9«t  to  ft  and 
start  gathering 


break; 

case  BeeState. GatheringNectar: 

double  nectar  =  destinationFlower .HarvestNectar ( ) 
if  (nectar  >  0) 

NectarCollected  +=  nectar; 

else 

CurrentState  =  BeeState. ReturningToHive; 
break; 


nectar. 
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This  is  the  e*it  When 
the  hive  stores  its  "E*it 
location,  it  Corresponds  to 
the  point  on  the  Hive  -form 
that  shows  the  picture  of 
the  ev.it  ^ 


This  is  the  entrance  When 
the  bees  -fly  bath  to  the 
hive,  they  fly  towards  the 
entrance  of  the  hive  on 
the  field  form  ( 

/ 

That  s  why  the  location  dictionary  stores  two 
separate  'E*it'  and  "Entrance”  locations. 


} 


case  BeeState.ReturningToHive: 
if  ( ! InsideHive)  { 

if  (MoveTowardsLocation (hive.GetLocation ("Entrance") ) )  { 
InsideHive  =  true; 

location  =  hive.GetLocation  ("Exit")  ;  If  we've  made  it  to  the  We, 

update  our  location  and  the 
insidettive  states 


> 


else 

if  (MoveTowardsLocation (hive . GetLocation ("HoneyFactory") ) ) 
CurrentState  =  BeeState .MakingHoney ; 

break; 


case  BeeState .MakingHoney: 

if  (NectarCollected  <0.5)  { 
NectarCollected  =  0; 
CurrentState  =  BeeState . Idle; 


l( 


|f  the  hive  Could  vse  the 
^dtar  to  «ake  honey 

remove  it  from  the  bee 


Try  and  give  this 

else  ^ _ "“*»•  k*. 

if  (hive . AddHoney (0 . 5) ) 

NectarCollected  -=  0.5; 

else 

NectarCollected  =  0 

break; 

case  BeeState. Retired: 

//  Do  nothing!  We're  retired!  rcT-»"-  - -  ,  We  can 

break;  ,  rest  of  the  nectar  so 

0nCe  the  bee's  retired,  he  just  has  to  or>  another  mission 
wait  around  until  the  Hive  removes  him 
from  the  list-  Then  he's  off  to  Miami/ 


se»a«S&- 


Suppose  you  wanted  to  change  the  simulator  so  it  took  two  turns  to  reach 
a  flower,  and  two  turns  to  go  from  a  flower  back  to  the  hive.  Without  writing 
any  code,  which  methods  of  which  classes  would  you  have  to  change  to 
put  this  new  behavior  into  place? 
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pop  goes  the  world 


The  wain  form  tells  the  world  to  (ro() 

C  )kay,  so  you  know  that  the  world  advances  by  one  frame 
every  turn  its  Go  ( )  method  is  called.  But  what  calls  that  Go  ( ) 
method?  Why,  the  main  form,  of  course!  Time  to  lay  it  out. 

Go  ahead  and  add  a  new  form  to  your  project.  Make  it  look  like 
the  form  below.  We  re  using  some  new  controls,  but  we’ll  explain 
them  all  over  the  next  several  pages. 


The  ToolStrip  Control  puts 
a  toolstrip  at  the  fop  of 
your  form  You  din  add 
■the  two  buttons  usin<)  the  — 
dropdown  that  appears  on 
the  -form  Set  each  button  s 
DuplayStyle  to  Te*t 


Add  a  StatusStr.p  to 
put  a  status  bar  on 
the  bottom  Use  the 
dropdown  to  add  a 
StatusLabel  to  it 


Forml.cs  [Design]* 


I  Start  Simulation  Reset 

#  Bees 

#  Flowers 

Total  honey  in  the  hive 
Total  nectar  in  the  field 
Frames  run 
Frame  rate 

Simulation  paused 


object 


Main  form 


System. 


Bees  ) 

Rowers  V. 

HoneylnHive  ( 
NedarinFlowers 
FramesRun 
FrameRate  s* 


toolStrp  1  L_statiusStiipl  0  timer  1 


to  the 


The  "fool Strip  Control  adds  a  toolbar  to  the  top  of 
your  Torn.,  and  StatusStr.p  adds  a  status  bar  to  the 
bottom  But  they  also  appear  as  icons  in  the  area 
below  the  form,  so  you  can  edit  the.r  properties- 


Bach  of  these  labels 
lives  in  one  Cell  of  a 
TableLayoutPanel  control 
ybu  lay  it  out  just  I'he  a 
table  in  Microsoft  Word 
Click  on  the  little  black 
arrow  to  add,  remove,  and 
rcstzjC  Columns  rows 


Add  a  Timer  Control 
to  the  form.  |t 
doesn't  show  up  at 
jll  its  a  non— visual 
Component  that  the 
form  designer  displays 
as  an  icon  in  the  space 
below  the  form 


foreach  (Flower  flower  in  Flowers) 
flower . Go (random) ; 

foreach  (Bee  bee  in  Bees) 
bee . Go ( random) ; 


I  hive . Go ( random) 71 


tof  RD1* 
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We  caw  use  World  to  get  statistics 

Now  we  want  to  update  all  these  controls.  But  we  don’t  need  click 
handlers  for  each  one;  instead,  let’s  use  a  single  method  that  will 
update  the  different  statistics  in  the  simulator  window: 


private  void  UpdateStats (TimeSpan  f rameDuration) 
Bees. Text  =  world. Bees .Count .ToString () ; 
Flowers. Text  =  world. Flowers .Count .ToString ( ) 


Th's  indicates  how  long  passes  for 
a  W..  we'll  have  to  send  this 
parameter  in  -from  somwhere  else, 
in  just  a  -few  pages 

Most  this  gust 

involves  getting 

data  from 

the  world  and 


Be  sure 
you  rndteh 
your  label 
names  on 
the  form 
with  your 
Code 


HoneylnHive.Text  =  String. Format  ("{0:f3}",  wor Id. Hive. Honey)  ;  ^dating labels 
double  nectar  =  0; 

foreach  (Flower  flower  in  world. Flowers) 
nectar  +=  flower .Nectar ; 

NectarlnFlowers . Text  =  String. Format ("{ 0 : f 3 ) ",  nectar) 

FramesRun.Text  =  framesRun .ToString () ; 
double  milliseconds  =  frameDuration.TotalMilliseconds; 
if  (milliseconds  !=  0.0) 


Print  the  first  parameter 
as  a  number  with  no 
decimals,  then  a  space,  then 
print  the  second  Parameter 
with  one  decimal  followed 
by  the  letters  "ms"  (in 
parentheses) 


JmfS 


FrameRate . Text  =  string . Format ("{ 0 : fO }  ({l:fl)ms)" 

1000  /  milliseconds,  milliseconds) 

The  frame  rate  is  the  number  of  fra 
run  per  second  We're  using  a  TimeSpan 
object  to  store  how  long  it  took  to  run  the 
frame  We  divide  \000  by  the  number  of 
milliseconds  it  took  to  run  the  frame-that 
gives  US  the  total  number  of  milliseconds  ,t 
took  to  run  the  last  frame 


O 


This  Code  uses  the  same 
String  FormatO  method  you 
used  in  the  hen  dump  But 
instead  of  printing  in  hen 
using  “nZ",  you  use  Mf3"  to 
display  a  number  with  three 
decimal  places. 


You’re  right,  we  need  to  create  the  World  object.  Add  this 
line  to  your  form’s  constructor: 

public  Forml ()  { 

InitializeComponent ( ) ; 

world  =  new  World () ; 

) 

Go  ahead  and  add  a  private  World  field  to  your  form 
called  world. 

That  just  leaves  all  the  time-related  code.  We’ve  always  said 
we  needed  a  way  to  run  Go  ( )  in  World  over  and  over- 
sounds  like  we  need  some  sort  of  timer. 


A 


We'll  talk  more 
about  this 
when  we  Create 
that  TimeSpan 
object 
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play  it  again 


timers  fire  events  over  and  over  again 

Remember  how  you  used  a  loop  to  animate  the  greyhounds?  Well,  there’s 
a  better  way  to  do  it.  A  Timer  is  an  especially  useful  component  that 
triggers  an  event  over  and  over  again,  up  to  a  thousand  times  a  second. 


Take  a  minute  and  create  a  new  project 
so  you  tan  see  how  timers  work  Then  we  II 
yt  back  to  tbe  simulator  and  put  your 
new  knowledge  to  work 


r 


Do  tMs 


Create  a  new  project  with  a  timer  and  three  buttons 

You  don’t  have  to  close  your  current  project  just  pop  open  a  new  Visual  Studio  and 
start  up  a  new  project.  Drag  a  timer  and  three  buttons  onto  the  form.  Click  on  the  timer 
icon  at  the  bottom  of  the  designer  and  set  its  Interval  property  to  1000.  That  number  is 
measured  in  milliseconds — it  tells  the  timer  to  fire  its  tick  event  once  a  second. 

Open  the  IDE’s  Properties  window  and  click  on  the  Events  button. 

(Remember,  the  Events  button  looks  like  a  lightning  bolt,  and  it  lets  you  manage  the 
events  for  any  of  your  form’s  controls.)  The  timer  control  has  exactly  one  event,  l  ick. 
Click  on  the  Timer  icon  in  the  designer,  then  double-click  on  its  row  in  the 
Events  page,,  and  the  IDE  will  create  a  new  event  handler  method  for  you  and  hook  it 
up  to  the  property  automatically. 


The  Events  button  m  the 
Properties  window  lets  you 
xork  with  all  the  events 
for  each  of  your  Controls- 

The  bottom  of  the  window  f 
bas  a  description  of  the  event- 


Properties 


System.  Windows.Forms.Timer 


timerl  Tick 


Occurs  whenever  the  specified  interval  time  elapses. 


Add  code  to  the  Tick  event  and  to  your  buttons. 

Here’s  some  code  that  will  help  you  get  a  sense  of  how  the  timer  works: 
private  void  timerl_Tick (object  sender,  EventArgs  e)  { 
Console . WriteLine (DateTime .Now.ToString ( ) ) ;c _ 


These  buttons  let 
you  play  with  the 
Enabled  property 
and  the  StartO 
and  StopO 
methods.  The 
first  one  switches 
Enabled  between 
true  and  false,  and 
the  other  two  call 
the  StartO  and 
StopO  methods- 


The  T imer  Control  has 
—  one  event  called  Tick. 

If  you  double-click  here, 
the  IDE  creates  an 
event  handler  method 
for  you  automatically. 

This  statement  *mites  the 

turrent  date  and  We  tot 

output  Check  the  output 
.  uandow  to  ~ake  sure  the  1 1 
event  is  f  ired  once  a  second 
(every  1000  milliseconds^. 


private  void  toggleEnabled_Click (object  sender,  EventArgs 
if  (timerl .Enabled) 

timerl. Enabled  =  false;  ^  Ws  EnaWed  ^  ■ 

starts  and  stops  the  timer. 

timerl .Enabled  =  true; 


private  void  startTimer_Click (object  sender,  EventArgs  e) 

timerl .Start () ;  ^ - - 

Console. WriteLine ("Enabled  =  "  +  timerl .Enabled) ; 

1 

private  void  stopTimer_Click (object  sender,  EventArgs  e) 

timerl  .Stop  () ;  ^ _ _ 

Console .WriteLine ("Enabled  =  "  +  timerl .Enabled) ; 


The  timer's  StartO  method 
starts  the  timer  and  sets 
Enabled  to  true  The  StopO 
(  method  stops  the  timer  and 
sets  Enabled  to  false- 
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The  timer's  using  a  delegate 
behind  the  scenes 


The  •timer's  Tick  event 
is  an  average,  everyday 
event  handler,  just 
like  the  ones  to  handle 
button  clicks.  \ 


How  do  G#  and  .NET  tell  llie  tinier  what  to  do  every  tick?  How 
does  the  timer  1  Tick  ( )  method  get  run  every  time  your 
timer  tirks?  Well,  we’re  hark  to  events  and  delegates,  just 
like  we  talked  about  in  the  last  chapter.  Use  the  IDE’s  “Go  To 
Definition”  feature  to  remind  yourself  how  the  Event  Handler 
delegate  works: 


Right-click  on  your  timerl  variable  and  select  "So  To  Definition" 

The  “Go  To  Definition”  feature  w  ill  cause  the  IDE  to  automatically  jump  to  the  location  in  the  code 
where  the  timerl  variable  is  defined.  The  IDE  will  jump  you  to  the  code  it  created  to  add  timerl 
as  a  property  in  the  Form  1  object  in  form  1  .Designer.es.  Scroll  up  in  the  file  until  you  find  this  line: 


this . timerl . Tick 

T 

This  is  the  Tick  event 

of  'your  timer  Control 
You've  set  this  to  oCCur 
e^evy  1000  milliseconds 


new  bystem. hventHanaier (tni: 

t 

Here  s  one  of  the  System's 
delegates,  the  basic  event 
handler  It's  a  delegate ..  a 
footer  to  one  or  more  methods. 


Now  right-click  on  EventHandler  and  select  "So  To  Definition" 

The  IDE  will  automatically  jump  to  die  code  that  defines  EventHandler.  Take  a  look  at  the  name 
of  new  tali  that  it  opened  to  show  you  die  code:  “EventHandler  [from  metadata]”.  This  means  diat 
the  code  to  define  EventHandler  isn’t  in  your  code.  It’s  built  into  the  .NET  framework,  and  the  IDE 
generated  a  “fake”  line  of  code  to  show  you  how  it’s  represented: 


public  delegate  void  EventHandler (object  sender,  EventArgs  e) ; 


,  .  f  ivjoe  Even tHandlc* 
each  evert  *  b  ^  the 

So  our  Tide  event .  1* 

fcmerl  JUkO 


Here's  why  every  event  in  C#  generally  takes 
an  Object  and  EventArgs  parameter-that’s 
the  -form  of  the  delegate  that  C#  de-fines 
•for  event  handling. 


What  code  would  you  write  to  run  the  World's  Go()  method 
every  500  milliseconds  in  our  beehive  simulator? 
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Add  a  Timer  to  the  simulator 

Let's  add  a  timer  to  the  simulator.  You've  already  got  a  timer  control, 
probably  called  timer  1.  Instead  of  using  the  1L)E  to  generate  a 
timerl  Tick  ( )  method,  though,  we  can  wire  the  timer  to  an  event 
handler  method  called  RunFrame{)  manually: 

TimeSpan  has  properties  like  Days,  Hours, 
Seconds,  and  Milliseconds  that  let  you 


measure  the  span  in  different  units 


Date  Time  fTimeSpa* 

■N£T  uses  the  DateTime  class  to 
store  information  about  a  time,  and 
its  Now  property  returns  the  Current 
date  and  time.  If  you  want  to  -find 
the  difference  between  two  times,  use 
a  TimeSpan  object  just  subtract  one 
DateT ime  object  -from  another,  and 
that'll  return  a  TimeSpan  obect  that 
holds  the  difference  between  them 


public  partial  class  Forml 
World  world;  _ 


Form  { 


private  Random  random  = 
private  DateTime  start  < 
private  DateTime  end; 
private  int  framesRun  = 

public  Forml ()  { 

InitializeComponent () 
world  =  new  World(); 


50; 


new  Random ( ) 

=  DateTime . Now ; 

«£ - 

0; 


Vou  should  have  a  Worifl 


These  will  be  used  to  figure  out 
how  long  the  simulator's  been 


running  at  any  given  point 
Wit  want  to  keep  up  with 

how  many  frames-or 
turns-have  passed 


Run  every 


<50  milliseconds 


We  set  the  handler  to  our  own 
method,  RunFrameO- 


timerl . Interval  = 

timerl. Tick  +=  new  EventHandler (RunFrameT; 
timerl  .Enabled  =  false;  starts 

UpdateStats (new  TimeSpan () ) ; 

}  We  also  start  out  by  updating  stats,  w.th 

new  TimeSpan  (.0  time  elapsed). 

private  void  UpdateStats (TimeSpan  f rameDuration)  ( 

//  Code  from  earlier  to  update  the  statistics 


A  second 
is  IOOO 
milliseconds,  so 
our  timer  will 
tick  Z 00  times 
a  second. 


public  void  RunFrame (object  sender,  EventArgs  e)  { 

f ramesRun++ ;  ^ -  grease  the  frame  Count,  and 

tell  the  world  to 


) 


world . Go (random) 
end  =  DateTime .Now; 

TimeSpan  f rameDuration  =  end  -  start; 

start  =  end;  - - 

UpdateStats (f rameDuration) ; 

Fmalty.  tkt  WV* 

with  the  new  time  duration 


Next,  we  figure  out  the 
time  elapsed  since  the  last 
frame  was  run. 
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Your  job  is  to  write  the  event  handlers  for  the  startSimulation  and 
reset  buttons  in  the  ToolStrip.  Here's  what  each  button  should  do: 


I- f  you  haven't 
dragged  a  ToolStrip 
and  StatwsStrip  out 
of  the  toolbox  and 
onto  your  -form,  do 
rt  now. 


1 .  Initially,  the  first  button  should  read  "Start  Simulation." 
Pressing  it  causes  the  simulation  to  start,  and  the 
label  to  change  to  "Pause 
Simulation."  If  the  simulation 
is  paused,  the  button  should 
read,  "Resume  simulation." 


2.  The  second  button  should 
say  "Reset.”  When  it's 
pressed,  the  world  should 
be  recreated.  If  the  timer  is 
paused,  the  text  of  the  first 
button  should  change  from 
"Resume  simulation"  to  "Start 
Simulation.” 


TKere’s  »o  imjle  ^  *■>  ««  *£*"7*  ^ 
want  you  to  think  about  what  S  lert  to  do 

1 


Forml.cs  [Design ]+ 


▼  X 


KH 

1:  StartSimulation  Reset 

#  Bees 

Bees 

#  Flowers 

Rowers 

Total  honey  in  the  hive 

HoneylnHive 

Total  nectar  in  the  field 

NectarlnFlowers 

Frames  run 

FramesRun 

Frame  rate 

FrameRate 

Simulation  paused 

toolStrlp  1  L_  statusStrlp  1  0  timer  1 


Sharpen  your  pencil 


^  What  do  you  think  is  left  to  be  done  in  this  phase 
of  the  simulator?  Try  running  the  program.  Write 
down  everything  you  think  we  still  need  to  take 
care  of  before  moving  on  to  the  graphical  stuff. 


tlierejare  no 

“  Dumb  Questions  “ 

Qj  We’ve  been  using  the  term 
“turn,”  but  now  you're  talking  about 
frames.  What’s  the  difference? 

Semantics,  really.  We  re  still 
dealing  in  turns:  little  chunks  of  time 
where  every  object  in  the  world  gets 
to  act.  But  since  we'll  soon  be  putting 
some  heavy-duty  graphics  in  place, 
we've  started  using  “frame",  as  in  a 
graphical  game's  frame-rate. 
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get  it  going 


Your  job  was  to  write  the  event  handlers  for  the  Start  Formi.cs  [Design]*  ▼  X 

Simulation  and  Reset  buttons. 


public  partial  class  Forml  :  Form  { 
//  variable  declarations 


public  Forml ()  { 

InitializeComponent () ; 
world  =  new  World(); 

} 

private  void  FormlLoad (object  sender,  tArgs  e)  { 
//  code  to  start  simulator 

} 

private  void  UpdateStats (TimeSpan  f rameDuration)  { 
//  Code  from  earlier  to  update  the  statistics 

) 

public  void  RunFrame (object  sender,  EventArgs  e)  { 
//  event  handler  for  timer 

} 


o 

[i  Start  Simulation  Reset 

#  Bees 

Bees 

P  Rowers 

Total  honey  in  the  hive 
Total  nectar  in  the  field 
Frames  run 

Flowers 

HoneytnHrve 

NecterlnFlowers 

FramesRun 

Frame  rate 

FrameRate 

[Smiabon  paused 

^tocCtrpl  i— statusStripl  Odmerl 


0^ 

ExeRciSe 

Solution 


C 


Be  s« re 

r\ 

TOTm  s 

tontrol 

names 

matth 


private  void  startSimulation_Click (object  sender,  EventArgs  e)  { 
if  (timerl .Enabled)  { 

Text  =  "Resume  simulation" , 


— >■  toolStripl . Items [0] 

timerl . Stop ( ) ; 

}  else  { 

toolStripl . Items [0] . Text  =  "Pause  simulation 
timerl . Start () ; 

} 

with  what^ 

you  use  In  '  — 

your  Code  private  void  reset_Click (object  sender 

framesRun  =  0;  - - - — 

if  ( ! timerl . Enabled) 

toolStripl . Items [0] . Text  =  "Start  simulation 

)  ^ 

The  only  time  we  need  to  dhanae 


I 


onr 


tie  -first  butWs  label  is  it  it  says, 
Kesume  simulation."  If  it  says,  "Pause 
simuation,"  it  doesn't  need  to  change 


and 


EventArgs  e)  { 


•  Resetting  ibe  s,mulaW  « 
just  a  matttr  of  retreating 
the  World  instance  and 
resetting  tramesRun 
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Test  drive 

You’ve  done  a  ton  of  work.  Compile  your 
code,  fix  any  typos,  and  run  the  simulator. 
How’s  it  look? 


Your  rUrt/^ause  and 
rtset  buttons  should 
all  work 


a 

•  Resume  simulation  Reset 


#  Bees 

6 

#  Flowers 

10  ,  . 

Total  honey  in  the  hive 

0.200 

Total  nectar  in  the  field 

31.700 

Frames  run 

275 

Frame  rate 

25  (40.1ms) 

Simulation  paused 


*°r,d  moves  along 


uiww*,...  our  status  strip 
XC>»S  to  be  the  only 
thing  not  working. 


Here's  your  chance  to  put  together  everything  you've  learned.  We  need  to 
allow  bees  to  tell  our  simulator  what  they're  doing.  When  they  do,  we  want 
our  simulator  to  update  the  status  message  in  the  simulator. 

This  time,  it's  up  to  you  to  not  only  write  most  of  the  code,  but  figure  out 
what  code  you  need  to  write.  How  can  you  have  a  method  in  your  simulator 
that  gets  called  everytime  a  bee  changes  its  state? 

To  give  you  a  little  help,  we've  written  the  method  to  add  to  the  form.  The 
Bee  class  should  call  this  method  any  time  its  state  changes: 


ore 

rA 


private  void  SendMessage (int  ID,  string  Message)  { 

statusStripl . Items [0] .Text  =  "Bee  #"  +  ID  +  "  +  Message; 

} 
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Hive  revived  some  Changes,  as  well 


4 


public  class  World  { 

//  all  our  existing  code 

public  World (Bee . BeeMessage  messageSender) 

Bees  =  new  List<Bee>(); 

Flowers  =  new  List<Flower> () ;  ^  _ 

Hive  =  new  Hive (this,  messageSender); 

Random  random  =  new  Random ( ) ; 
for  (int  i  =  0;  i  <  10;  i++) 

AddFlower (random) ; 


T!£  ^  "“/*  *•  i-«  * 

iu /r  passes  «*  t»* 

mctKo d  **  tall  to  the  Hive  instance. 


sT 


Last  but  not  least,  here's  the 
updated  form.  Anything  not  shown 
stayed  the  same 


public  partial  class  Forml 
//  variable  declarations 


Form  { 


We  create  a  new  delegate  from  the 
Bee  class  (make  sure  you  declared 
BeeMessage  public),  and  point  if  at 
our  SendMessageO  method 


public  Forml ( )  { 

InitializeComponent  () ;  -  •s. 

world  =  new  World(new  Bee .BeeMessage (SendMessage) );  ^ 

//  the  rest  of  the  Forml  constructor 


private  void  reset_Click (object  sender,  EventArgs  e) 
frame sRun  =  0 ; 

world  =  new  World (new  Bee . BeeMessage (SendMessage) ) ; 
if  ( !  timerl .  Enabled) 

toolStripl . Items [0] .Text  =  "Start  simulation"; 

} 


{ 


,  ™  the  " 

to  call  back 


'cxnod  +or 


private  void  SendMessage (int  ID,  string  Message) 
statusStripl . Items [0] .Text  =  "Bee  #"  +  ID  +  " : 


} 


} 


This  is  the  method  we  gave 
.you  be  sure  to  add  it  in,  too 


{ 

"  +  Message; 
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Let's  work  with  groups  of  bees 

Your  bees  should  be  buzzing  around  the  hive  and  the  field, 
and  your  simulation  should  be  running!  How  cool  is  that?  But 
since  we  don’t  have  die  visual  part  of  the  simulator  working 
yet — that’s  what  we’re  doing  in  the  next  chapter  all  the 
information  we  have  so  far  is  the  messages  that  the  bees  are 
sending  back  to  the  main  form  with  their  callback.  So  let’s 
add  more  information  about  what  the  bees  are  doing. 


r- . 


You  know  enough  to  gather  the  information  you’d  need  to  populate  that 
ListBox — take  a  minute  and  think  through  how  that  would  work.  But  it’s  a 
little  more  complex  than  it  seems  at  first.  What  would  you  need  to  do  to 
figure  out  how  many  bees  are  in  each  of  the  various  Bee .  State  states? 
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A  collection  collects...  PAT  A 

Our  bees  are  stored  in  a  List,  which  is  one  of  (’.#'s  collection 
types.  And  collection  types  really  just  store  data...  a  lot  like 
a  database  does.  So  each  bee  is  like  a  row  of  data,  complete 
with  a  state,  and  ID,  and  so  on.  Here's  how  our  bees  look  as  a 
collection  of  objects: 


There's  a  lot  of  data  in  the  Bee  objects’  fields.  You  can  almost 
think  of  a  collection  of  objects  the  same  way  you  think  of 
row  s  in  a  database.  Each  object  holds  data  in  its  fields,  the 
same  way  each  row  in  a  database  holds  data  in  its  columns. 


Database 


;  ID  =  987 

currentState  =  MakingHoney  * 

■  ID  =  12  currentState  =  FlyingToFlower 

ID  = 1982 

currentState  =  GatheringNectar  | 

»  toe  Ule  W  *,  © 
a  toLnfi 


Most  collections-especially 
wken  tkey  kold  okjects- 
can  ke  tkougfkt  of  as  data 
stores,  just  like  a  database. 
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What  if  you  could  query  collections, 
databases,  and  even  XML  documents 
with  the  same  basic  syntax? 

C#  has  a  really  useful  feature  called  LINQ  (which 
stands  for  Langauge  INtegrated  Query).  The  idea 
behind  LINQ  is  that  it  gives  you  a  way  to  take  an  array, 
list,  stack,  queue,  or  other  collection  and  work  with  all 
the  data  inside  it  all  at  once  in  a  single  operation. 

But  what's  really  great  about  LINQ  is  that  you  can  use 
the  same  syntax  that  works  with  collections  as  you  can 
for  working  with  databases. 


Carter  1 5  , 

with  L/M?. 


of 

*9 


,«oY-ks  essentially 
La  m  a  dollett-on 


current! 


database 


currentState  =  Flyir>gToFlo\ver 


currentState  =  Gathering  Nectar 


ID  =  987  [  currentState  =  MakingHoney  l 
ID  =  12  |  currentState  =  FlyingToFlower 
D  =  1982  I  currentState  =  GatheringNectar 


wc  bad  our  bee  ddfd  m  a  database— 
or  even  an  )<ML  -file— L|N<$  dould  work 
^  --  ^  with  them  in  exactly  the  same  way 

<bee  id="987"  currentState=’MaklngHoney"  /> 

XML  -bee  id='12‘  currentState='FlyingToFlower'  /» 

^  <bee  id-'1982"  cjrrentStale-'GathenngNectar*  /> 
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UNQ  wakes  working  with  data  in 
collections  and  databases  easy 

We’re  going  to  spend  an  entire  chapter  on  LINQ_  before  long,  but  we  can 
use  LINQ_and  some  Ready  Bake  Code  lo  add  some  extra  features  to  our 
simulator.  Ready  Bake  Code  is  code  you  should  type  in,  and  it’s  okay  if 
you  don’t  understand  it  all.  You’ll  learn  how  it  all  works  in  Chapter  15. 


Reapy  Bake 

Cope 


private  void  SendMessage ( int  ID,  string  Message) 
statusStripl . Items [0] .Text  =  "Bee  #"  +  ID  +  " 
var  beeGroups  = 

from  bee  in  world. Bees 

group  bee  by  bee .CurrentState  into  beeGroup 
orderby  beeGroup. Key 
select  beeGroup; 

, — >  listBoxl . Items . Clear ( ) ; 


+  Message; 


™,s  ,s  *  LIW  ^  takes  all  the 
bees  m  the  Bees  Collection,  and  groups 
then,  by  thenr  CurrentState  property 
The  group’s  Xcy  is  the  bee's 
CurrentState,  so  that's  the  order  the 


,  ,  t  W !  .  states  will  be  displayed  on  the  tom. 

Make  sure  foreach  (var  group  in  beeGroups)  ( 

this  watches  strings;  - beeGroups  is  trow  the  LfM$  ^uery.  We  can 

if  (group. Count  ()  ==  1)  the  wewbers,  and  iterate  over  thew. 

s  = 


the  list  bo* 

Control  s 


nawe  on 
you  r  torw 


else  This  bit  ot  code  wakes  sure  it  says,  "I  bee 

s  =  «s " ;  and  “3  bees",  keeping  the  plural  right 

listBoxl. Items. Add(group. Key. ToStringO  + 

+  group. Count ()  +  "  bee 
if  (group. Key  ==  BeeState . Idle 
&&  group. Count ( )  ==  wor Id. Bees .Count () 

&&  framesRun  >0)  {  ^ - ’ 

listBoxl. Items. Add ("Simulation  ended:  all  bees  are  idle"); 
toolStripl .  Items  [0]  .Text  =  "Simulation  ended";  ^ <»?  it  AC-C 


„ .  «  Finally,  add  the  group 

status  (its  key)  and 

*3!;  count  to  the  list  bo*- 

^es  another  nice 
feature.  Since  we  know 
how  wany  bees  are  idle  .. 


statusStripl . Items [0] .Text  = 
timer 1 .Enabled  =  false; 


'Simulation  ended" 

- - - 


...we  tan  see 

bees  are  idle  It-  so, 
the  hive’s  out  ot  honey, 
so  let’s  stop  the 


Simul 


.lation 


We’ll  learn  a  lot  more  about  LINQin 
upcoming  chapters. 

You  don’t  need  to  memorize  LINQ  syntax  or 
try  to  drill  all  of  this  into  your  head  right  now. 
You’ll  get  a  lot  more  practice  working  with  I.INQ_in  Chapter  15. 
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save  the  world 


Test  drive  (Part  l) 

Go  ahead  and  compile  your  rode  and  run  your  project  II 
you  get  any  errors,  double-check  your  syntax,  especially 
with  the  new  LINQcode.  Then,  fire  up  your  simulator! 


The  tw»er  or 

simulator 


LWQ  queries 
your  Collec-fci 

ons 

h>  teed  you  this 
data  every  turn. 


ii  Pause  simulation  Reset 


c 


3l 


Beehive  Simulator 


#  Bees 

#  Flowers 

Total  honey  in  the  hive 
Total  nectar  in  the  field 
Frames  run 
Frame  rate 

FlyingTo Flower:  2  bees 
GatheringNectar:  1  bee 
RetumingToHive:  1  bee 
MakingHoney:  2  bees 


Bee  #4:  MakingHoney 


Bees  tall  back  your  simulator 
form  to  update  the  form  every 
time  their  status  thanes 


These  stats  Come  tr  om 
the  -form  Querying  the 
World  object 
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One  final  challenge:  Open  and  Save 

We’re  almost  ready  to  take  on  graphics,  and  add  some  visual  eye  candy  to 
our  simulator.  First,  though,  let’s  do  one  more  thing  to  this  version:  allow 
loading,  saving,  and  printing  of  bee  statistics. 


Vou'll  add  the  fVi*t 

Add  the  Open,  Save,  and  Print  icons  button  now— we'll  >*ake 

The  ToolStrip  control  has  a  really  useful  feature — it  can  automatically  insert  't  pvint  a  status  pa^e 

picture  buttons  for  standard  icons:  new,  open,  save,  print,  cut,  copy,  paste,  and  help.  the  hive  in  the 
Just  right-click  on  the  ToolStrip  icon  at  die  bottom  of  die  Form  Designer  window  r'C*t  Chapter 
and  select  “Insert  Standard  Items”.  Then  click  on  die  first  item — dial's  the  “new” 
icon  and  delete  it.  Keep  the  next  three  items,  because  they’re  the  ones  we  need 
(open,  save  and  print).  After  that  conies  a  separator;  you  can  either  delete  it  or 
move  it  between  the  Reset  button  and  the  save  buton.  Then  delete  the  rest  of  the 
buttons. 


Add  the  button  event  handlers 

Ihe  new  standard  buttons  are  named  openToolStripButton,  saveToolStripButton  and 
printToolStripButton.  Just  double-click  on  them  to  add  their  event  handlers. 


Add  code  to  make  the  save  and  open  buttons  work 


1.  Make  the  save  button  serialize  the  world  to  a  file.  Stop  the  timer  (you  can  restart  it  after  saving)  Set 
MessageSender  to  null  for  the  hive  and  all  the  bees,  so  NET  doesn't  try  and  serialize  the  code  your  delegates 
point  to  the  form  itself.  Display  a  Save  dialog  box,  and  then  serialize  the  World  object,  and  the  number  of  frames 
that  have  been  run.  Don't  forget  to  reattach  the  SendMessage  ( )  when  you're  done  saving 


2.  Make  the  open  button  deserialize  the  world  from  a  file.  Take  care  of  the  timer  just  like  in  the  save  button,  pop  up 
an  Open  dialog  box,  and  deserialize  the  world  and  the  number  of  frames  run  from  the  selected  file  Then  you  can  hook 
up  the  MessageSender  delegates  again  and  restart  the  timer  (if  necessary). 


3.  Don’t  forget  about  exception  handling!  Make  sure  the  world  is  intact  if  there's  a  problem  reading  or  writing  the 
file.  Consider  popping  up  a  human-readable  error  message  indicating  what  went  wrong. 
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exrecise  solution 


Exercise 

Solution 


Your  job  was  to  make  the  Save  and  Open  buttons  work. 

Don't  forjet  tV,e  US'^ 

using  System. 10; 

using  System. Runtime . Serialization . Formatters . Binary; 


You'll  need  to  make  the  World,  Hive,  Flower, 
and  Bee  classes  serializable  When  you 
serialize  the  world,  HBT  will  -find  its 
references  to  Hive,  Flower  and  Bee  objects 
and  serialize  them  too. 


Here’s  the  Code  for  the  Save  button 


[Serializable] 

public  class  World  { 

[Serializable] 

public  class  Hive  { 

[Serializable] 

public  class  Flower  ( 

[Serializable] 

public  class  Bee  { 


private  void  saveToolStripButton_Click (object  sender,  EventArgs  e)  { 
bool  enabled  =  t inter  1  .Enabled; 

if  (enabled)  ^  dor>'t  ^  all  the  Messa^eSender  delegates 

timer  1 .  Stop  () ;  to  null,  then  when  we  try  to  serialize  the  world 

world. Hive. MessageSender  =  null;  /  ley'll  act  as  a  reference  to  Forml,  and  the 

n.  rr  .11 _ .11  4-vs,  to  write  out  our  form 


foreach  (Bee  bee  in  world. Bees) 
bee .MessageSender  =  null; 


BinaryFormatter  will  try  to  write 


SaveFileDialog  saveDialog  =  new  SaveFileDialog ( ) ; 
saveDialog. Filter  =  "Simulator  File  (* .bees) I  * .bees 
saveDialog. CheckPathExists  =  true; 

saveDialog. Title  =  "Choose  a  file  to  save  the  current  simulation"; 
if  (saveDialog. ShowDialog ()  ==  DialogResult.OK)  { 
try  { 

Here’s  where  C  BinaryFormatter  bf  =  new  BinaryFormatter  () ; 

the  world  is  S.  using  (Stream  output  =  File. OpenWrite (saveDialog. FileName) ) 

written  out  /  bf  .Serialize  (output,  worl^T-^. 

to  a  f  ile-  \  bf .Serialize (output,  framesRun) 


We  decided  to  use  "  bees" 
as  the  extension  for 
simulator  save  files. 


{ 


) 


Remember,  when  we  ser.al.ze  World,  everythin* 
-t  references  yts  serialized-  all  the  bees, 


flowers,  and  the  hive. 


) 

catch  (Exception  ex)  { 

MessageBox. Show ("Unable  to  save  the  simulator  file\r\n"  +  ex. Message, 
"Bee  Simulator  Error",  MessageBoxButtons .OK,  MessageBoxIcon. Error); 


} 

} 

world. Hive. MessageSender  =  new  Bee . BeeMessage (SendMessage) ; 
foreach  (Bee  bee  in  world. Bees) 

bee. MessageSender  =  new  Bee. BeeMessage (SendMessage) ; 
if  (enabled) 

timerl .Start () ; 


After  we  save  the 
file,  we  need  to  hook 
{  UP  the  MessajeSender 
r  delegates  aja.n,  ahd 

_ )  then  restart  the  timer 

Gf  stopped  it). 


) 
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JWs  the  Code  tKe 
-  0?en  button. 


private  void  openToolS tr ipBu ttori—Cliclcl ob j ect  sender,  EventArgs  e)  { 
World  currentWorld  =  world; 

int  currentFraraesRun  =  f r ame?R u nT~~ —  Before  opening  -the  -file  and  reading  £rom  it, 

save  a  reference  -bo  the  durrent  world  and 
-framesRun  If  there's  a  problem,  you  dan  revert 


bool  enabled  =  timerl .Enabled; 
if  (enabled) 

timerl .Stop () ; 


to  these  and  keep  running 


Set  up  the  Open 
file  dialog  bov. 
and  pop  <t  up- 


usin^  ensures 

the  stream 
^ets  closed 


OpenFileDialog  openDialog  =  new  OpenFileDialog ( ) ; 
openDialog . Filter  =  "Simulator  File  (* .bees) | * .bees"; 
openDialog .CheckPathExists  =  true; 
openDialog. CheckFileExists  =  true; 

openDialog. Title  =  "Choose  a  file  with  a  simulation  to  load"; 
if  (openDialog. ShowDialogO  ==  DialogResult .OK)  ( 
try  { 

BinaryFormatter  bf  =  new  BinaryFormatter () ; 

^ - s  using  (Stream  output  =  File .OpenRead (openDialog . FileName) )  { 

World  =  (World) bf . Deserialize (output)  _  , 

framesRun  =  (int)  bf .  Deserialize  (output)  _  Here  s  where  we  serialise 

^  the  world  and  the  number 

of  -frames  run  to  the  file- 


catch  (Exception  ex)  { 

MessageBox. Show ("Unable  to  read  the  simulator  file\r\n"  +  ex. Message, 
"Bee  Simulator  Error",  MessageBoxButtons .OK,  MessageBoxIcon . Error) ; 
world  =  currentWorld;  — m _ 

;  tftte f* crmltiM tt™« * „ 

r“Ue  tkt  »„ld  M 


framesRun  =  currentFramesRun; 


world. Hive. MessageSender  =  new  Bee.BeeMessage (SendMessage) 
foreach  (Bee  bee  in  world. Bees) 

bee. MessageSender  =  new  Bee . BeeMessage (SendMessage) ; 
if  (enabled) 

<* -  Onde  everything  <s  loaded,  ** 


timerl . Start ( ) 


Onde  eve. ,  —  j  , 

hook  badk  up  the  delegates  and 

restart  the  timer- 


1  oull  need  to  get  your  simulator  up  and  running  before  you  move  on 
to  tke  next  chapter.  You  can  download  a  working  version  irom  the 
Head  First  Lahs  website:  www.headfirstlabs.com/books/hfcsharp/ 
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13  controls  and  graphics 

^  -*fr 

+  Make  it  pretty  ■# 


Sometimes  you  have  to  take  graphics  into  your  own  hands. 

We’ve  spent  a  lot  of  time  on  relying  on  controls  to  handle  everything  visual  in  our 
applications.  But  sometimes  that’s  not  enough — like  when  you  want  to  animate  a  picture 
And  once  you  get  into  animation,  you’ll  end  up  creating  your  own  controls  for  your  NET 
programs,  maybe  adding  a  little  double  buffering,  and  even  drawing  directly  onto  your 
forms  It  all  begins  with  the  Graphics  object,  Bitmaps,  and  a  determination  to  not  accept 
the  graphics  status  quo 


this  is  a  new  chapter 
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objects  everywhere 


You've  been  using  controls  all  along 
to  interact  with  your  programs 

TextBoxes,  PictureBoxes,  Labels...  you’ve  got  a  pretty  good 
handle  by  now  on  how  you  can  use  the  controls  in  the  IDE’s  toolbox. 
But  what  do  you  really  know  about  them?  There’s  a  lot  more  to  a 
control  than  just  dragging  an  icon  onto  your  form. 


You  can  create  your  own  controls 

The  controls  in  the  toolbox  are  really  useful  for  building  forms  and 
applications,  but  there’s  nothing  magical  about  them.  They're  just 
classes,  like  the  classes  that  you’ve  been  writing  on  your  own.  In  fact, 
G#  makes  it  really  easy  for  you  to  create  controls  yourself,  just  by 
inheriting  from  the  right  base  class. 


Your  custom  controls  show  up  in  the  IDE's  toolbox 

There’s  also  nothing  mysterious  about  the  toolbox  in  the  IDE.  It 
just  looks  in  your  project’s  classes  and  the  built-in  .NET  classes  for 
any  controls.  If  it  finds  a  control  a  class  that  implements  the  right 
interface  then  it  displays  an  icon  for  the  class.  If  you  add  your  own 
custom  controls,  they’ll  show  up  in  the  toolbox,  too. 


Y< 


you  tan  trea-te  a  class 

that  .nhebts  ^0,B 

of  the  e*>st'*>2  Control 
classes— ere*  " 
doesn’t  have  any  other 
code  •*>  't-and  it  II 
1,.4-omatitalW  shoui  U?  .n 


You  can  write  code  to  add  controls  to  your  form,  and  even 
remove  controls,  while  your  program's  running 

Just  because  you  lay  out  a  form  in  the  IDE’s  form  designer,  that  doesn't  mean 
that  it  has  to  stay  like  that.  You've  already  moved  plenty  of  PictureBox 
controls  around  (like  when  you  built  the  greyhound  race).  But  you  can  also 
add  or  remove  controls,  too.  In  fact,  when  you  build  a  form  in  the  IDE,  all  it’s 
doing  is  writing  the  code  that  adds  the  controls  to  the  form...  which  means 
you  can  write  similar  code,  and  run  that  code  whenever  you  want. 
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Form  controls  are  just  objects 


You  already  know  how  important  controls  are  to  your  forms.  You’ve  been 
using  buttons,  text  boxes,  picture  boxes,  check  Ixixes,  group  boxes,  labels,  and 
other  forms  since  chapter  1.  Well,  it  turns  out  that  those  controls  are  just 
objects,  just  like  everything  else  you’ve  been  working  with. 


A  control  is  just  an  object,  like  any  other  object  it  just  happens  to  know  how¬ 
to  drawr  itself.  The  Form  object  form  keeps  track  of  its  controls  using  a  special 
collection  called  Controls,  which  you  can  use  to  add  or  remove  controls  in 


Jifs  get  started! 


How good'yO  Good  O  Better  ®  Best 


Each  Control  in  the  fot 
is  just  an  instance  of  a 
particular  object 


^ac/roBv^ 


System  .Wt 


Radide^ 


There  are  lO  Controls  on 
this  form,  so  the  Controls 
Collection  Contains  lO 
references  to  individual  ^ 
Control  objects. 


Control 
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how  cute! 


Use  controls  to  animate  the  beehive  simulator 

You’ve  built  a  great  simulator,  but  it’s  not  much  to  look  at.  It’s  time  to  create  a 
really  stunning  visualization  that  shows  those  bees  in  action.  You're  about  to 
build  a  tenderer  that  animates  the  beehive... and  controls  are  the  key. 


The  user  interface  shows  you  everything  that's  going  on 

Your  simulator  will  have  three  different  windows.  You’ve  already  built  the  main  “heads-up  display” 
stats  window  that  shows  stats  about  the  current  simulation  and  updates  from  the  bees.  Now  you’ll 
add  a  window  that  shows  you  what’s  going  in  inside  the  hive,  and  a  window  that  shows  the  field  of 
flowers  where  the  bees  gather  nectar. 


The  W"  7ou 
*  the  last  chapter 
heton.es  the  heads- 
u?  d.syla 7  tor  the 

Sirr>\Al3‘t0*r 


This  window  displays 
the  -field  o{  -flowers 
and  the  bees 
gathering  nedtar. - 


These  two  windows  are 
Child  windows— when 
you  minimize  the  mam 
window,  the  other  two 
disappear  along  with  it. 
iAnd  when  you  move  the 
main  window  around,  the 
other  two  -follow  it- 


This  window  shows  what’s 
going  on  in  the  hive- 


We'll  add  a  Print  button  to  the  stats  window 

The  stats  window  has  an  open  and  save  button  already.  Once  we  add  the  graphics, 
we  can  add  a  button  to  the  toolbar  to  print  an  info  page  about  what’s  going  on. 


*  Beehive  Simulator 


Pause  simulation  Reset 


#  bees 

#  Flowers 

Total  honey  in  the  hive 
Total  nectar  in  the  field 
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Tht  Hiv# 


The  hive  window  shows  you  what's  going  on  inside  the  hive 

As  the  bees  fly  around  the  world,  you'll  need  to  animate  each  one.  Sometimes  they’re 
inside  the  hive,  and  when  they  are.  they  show  up  in  this  window. 

_  TKe  hive  has  -three 

important  locations  in  it. 
The  bees  are  born  in  the 
►*rsery,  they  have  to  fly 
to  the  exit  to  leave  the 
hive  to  gather  nectar  from 
the  -flowers,  and  when  they 
Come  back  they  need  to  go 
to  the  honey  factory  to 
make  honey. 


The  hive  exit  is  on  the  hive  for*,  and 
the  entrance  is  on  the  field  form 
(That’s  why  we  pvt  both  of  them  in 
the  Hive’s  locations  dictionary ) 


The  field  window  is  where  the  bees  collect  the  nectar 

Bees  have  one  big  job:  collect  nectar  from  the  (lowers,  and  bring  it 
back  to  the  hive  to  make  honey.  Then  they  eat  honey  to  give  them 
energy  to  fly  out  and  get  more  nectar. 


Th*  Field 


Here’s  the  entrance  to  the 
hive.  When  bees  fly  into  it, 
they  disappear  from  the 
field  form  and  reappear  near 
the  Exit  in  the  hive  form 
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a  sweet  rendition 


Add  a  rewderer  to  your  architecture 

We  need  another  class  that  reads  the  information  in  the 
world  and  uses  it  to  draw  the  hive,  bees  and  flowers  on 
the  two  new  forms.  We’ll  add  a  class  called  Renderer 
to  do  exactly  that.  And  since  your  other  classes  are 
well-encapsulated,  that  won’t  require  a  lot  of  changes  to 
your  existing  code. 


.^This  is  'the  object  -foe  the  "'3'* 
f  window  that  you’ve  already  built 


Vou’ve  already  bu.lt  these  objects. 


The  World  object  keeps  track  of 
everything  in  the  simulator:  the 
state  of  the  hive,  every  bee  and 
every  flower. 


The  Hive  and 
field  ob/cts  are 
forms,  tied  to 
>ur  main  form 


^  Each  bee  knows  its 
jocation-and  we  can  use 
that  location  to  draw 
the  bee  on  the  form. 


The  renderer  reads  the 
information  from  the 
Warld  object  and  uses 
that  format  ion  {x> 
update  the  two  forms.  |t 
keeps  a  reference  to  the 
World  object,  as  well  as 
the  Hive  form  object  and 
the  field  form  object 


ren-der,  verb. 

to  represent  or  depict  artistically. 
Sally’s  art  teacher  asked  the  class  to  look 
at  all  of  the  shadows  and  lines  in  the 
mode!  and  render  them  on  the  page. 


Because  Bee, 

Hive,  Flower,  and 
World  are  well- 
encapsulated,  a 
class  tli at  renders 
those  objects  can 
be  added  without 
lots  of  changes  to 
existing  code. 
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The  Tenderer  draws  everything  in 
the  World  on  the  two  forms 


The  World  object  keeps  track  of  everything  in  the  simulation:  the 
hive,  the  bees,  and  the  flowers.  But  it  doesn't  actually  draw  anything 
or  produce  any  output.  That’s  the  job  of  the  Renderer  object.  It 


reads  all  of  the  information  in  the  World,  Hive 
objects  and  draws  them  on  the  forms. 


checks  fields  for  state 


display  windows 


The  simulator  renders  the  world  after  each  frame 


After  the  main  form  calls  the  world’s  Go  ( )  method,  it  should  call  the 
t  enderer’s  Render  ( )  method  to  redraw  the  display  windows.  For  example, 
each  flower  will  be  displayed  using  a  PictureBox  control.  But  let’s  go 
further  with  bees  and  create  an  animated  control.  You’ll  create  this  new 
control,  called  BeeControl,  and  define  its  behavior  yourself 


The  renderer  keeps  track  of  which  visual 
C°7.r°l  is  used  k  resent  a  particular  bee 
or  Flower  us.ng  Dictionary  objects,  where  the 
Dee  or  Flower  object  is  the  key. 
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Controls  are  well-suited  for 
visual  display  elements 

When  a  new  bee  is  added  to  the  hive,  we’ll  want  our  simulator  to  add  a  new 
BeeControl  to  the  Hive  form  and  change  its  location  as  it  moves  around  the 
world.  When  that  bee  Hies  out  of  the  hive,  our  simulator  will  need  to  remove  the 
control  from  the  Hive  form  and  add  it  to  the  Field  form.  And  when  it  Hies  back  to 
the  hive  with  its  load  of  nectar,  its  control  needs  to  be  removed  from  the  Field  form 
and  added  back  to  the  Hive  form.  And  all  the  while,  we'll  want  the  animated  bee 
picture  to  flap  its  wings...  and  controls  will  make  it  easy  to  do  all  of  that. 


The  world  adds  a  new  bee,  and  the  t  enderer  creates  a  new  BeeControl 
and  adds  it  to  the  Hive  form’s  Controls  collection. 


O 


When  the  bee  flies  out  of  the  hive  and  enters  the  field,  the  tenderer 
removes  the  BeeControl  from  the  hive’s  Controls  collection  and  adds 


A  bee  will  retire  if  it’s  idle  and  it’s  gotten  too  old.  If  the  Tenderer  checks 
the  world’s  Bees  list  and  finds  that  the  bee  is  no  longer  there,  it  removes  the 
control  from  the  Hive  form. 
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Sharpen  your  pencil 


Can  you  figure  out  what  each  of  these  code  snippets  does?  Assume 
each  snippet  is  inside  a  form,  and  write  down  your  best  guess. 


this. Controls. Add(new  ButtonO  )  ; 


Form2  childWindow  =  new  Form2(); 
childWindow. Backgroundlmage  = 

Properties .Resources. Mosaic; 
childWindow. BackgroundlmageLayout  = 
ImageLayout .Tile; 
childWindow. Show ( ) ; 

lf  y°u've  &  »  L.stBox  cm  w  ^ 
you  can  use  its  AddRangeO  „,etHod 
to  add  list  items  I 

Label  myLabel  =  new  Label ();  ^ 

myLabel.Text  =  "What  animal  do  you  like?" 
myLabel. Location  =  new  Point(10,  10); 
ListBox  myList  =  new  ListBoxO; 
mvList . Items . AddRange (  new  object [] 

{  "Cat",  "Dog",  "Fish",  "None"  )  ) 
myList. Location  =  new  PointdO,  40); 
Controls . Add (myLabel ) ; 

Controls .Add (myList) ; 


Label  controlToRemove  =  null; 
foreach  (Control  control  in  Controls)  ( 
if  (control  is  Label 

&&  control. Text  =  "Bobby") 
controlToRemove  =  control  as  Label; 


.  ' 

you  don't  need  to  write  down 
eatk  line,  as  much  as  summarize 
what  S  going  on  in  the  Code  block. 


Controls .Remove (controlToRemove) ; 
controlToRemove . Dispose ( ) ; 


Bonus  question:  Why  do  you  think 
we  didn’t  put  the  Controls. Remove() 
statement  inside  the  foreach  loop? 


Try  it  out  if  you  want,  and 
write  why  you  think  you  got  the 
result  that  MT  gave  you 


you  are  here  ► 


571 


buzz  buzz  buzz 


Can  you  figure  out  what  each  of  these  code  snippets  does?  Assume 
each  snippet  is  inside  a  form,  and  write  down  what  you  think  it  does. 


this .Controls .Add (new  Button ( ) ) ; 


Form2  childWindow  =  new  Form2(); 
childWindow.Backgroundlmage  = 

Properties . Resources .Mosaic; 
childWindow . BackgroundlmageLayout  = 
ImageLayout . Tile; 
chi ldWindow. Show () ; 


Create.  .a.  .*>?*  .tattw  .and.  add.  it.  .ip.  .the . 

form,  it.’H  .baye  .default.  xa  Ives .  (eju  .the.  lent, 
property.  swll .  be.  empty! . 

There .a  .second  .Form  .in.  ."the.  application . 

filled .  Form  2-,.  so.  ibis.  Creates.  .it.  sets  .'its, . 

batkyovnd  .imaje.  .to.  a.  r.esovr.ce.  .imaje.  called. . 
“Mosaic”, .  wakes .  tbe .  hacJ^rovnd  .imaje .  so.  it's. . 
tiled  .instead  .of .  stretibed*  .and  .then,  displays 
tbe  .window.  .to  .tbe  .vser. . 


Label  myLabel  =  new  Label (); 
myLabel.Text  =  "What  animal  do  you  like?"; 
myLabel. Location  =  new  Point (10,  10); 
ListBox  myList  =  new  ListBoxO; 
myList . Items .AddRange (  new  object [] 

{  "Cat",  "Dog",  "Fish",  "None"  )  ); 
myList. Location  =  new  Point(10,  40); 
Controls .Add (myLabel) ; 

Controls .Add (myList ) ; 


This  code .  Creates,  a .  new.  .Ia.be  I,.  sets  its  .text, 
and  moves  it.  t©  .a.  new  posit  on .  Then .  it . . . 
creates  a.  new  listbox,  adds  .foyr  .items  tp  tbe 
list,,  and  moves  it  just  y.nderneatb  tbe  .label-. 

(t  adds  tbe.  label  and  listbox  to  tbe.  form,  so 
they,  both  .jet  .displayed,  immediately. . 


Label  controlToRemove  =  null; 
foreach  (Control  control  in  Controls)  { 
if  (control  is  Label 

&&  control. Text  =  "Bobby") 
controlToRemove  =  control  as  Label; 


IK'S  J.<?op.  searches  .tbr.0r.5K  .all .  tbe  .Controls,  on. 
tbe  .form,  .vntil . it  .finds .a  .label .  with.  the.  .text . 
“Bobby” .  Qn  Ce  it.  finds,  .the.  JaheL  it.  removes  .it 
frflm.tbe.foVTh- . 


} 

Controls .Remove (controlToRemove) ; 
controlToRemove . Dispose ( ) ; 


it  w 


Bonus  question:  Why  do  you  think 
we  didn’t  put  the  Controls.Remove() 
statement  inside  the  foreach  loop? 


yby.  ca.n't  modify,  .the.  .Control?.  collection . 

(pjc.  any  .other.  .collkctlontin .the.  .middle,  of.  a.... 
for.ea.Cb  .loop.. that's. ite.ra.tin5. tb.rovjb. it . 
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Puild  your  first  animated  control 


You’re  going  to  build  your  own  control  that  draws  an  animated  lice 
picture.  If  you’ve  never  done  animation,  it’s  not  as  hard  as  it  sounds:  you 
draw  a  sequence  of  pictures  one  after  another,  and  produce  the  illusion  of 
movement.  Lucky  for  us,  the  way  G#  and  .NET  handle  resources  makes  it 
really  easy  for  us  to  do  animation. 


0\nCe  you  download  the  -to 


:  You  download  the  tour  bee 
animation  pictures  (Bee  animation  l.pno 
through  Bee  animation  t  png)  from  Head 
Piwt  Ubs,  you'll  add  them  to  your 
I /  pJect's  ^sources.  iVhen  you  flash  these 
««  one  after  another,  it'll 

_  ^\ook  like  their  wings  are  flapping. 


We  want  a  control  In  the  toolbox 

If  you  build  BeeControl  right,  it’ll  appear  as  a  control 
that  you  can  drag  out  of  your  toolbox  and  onto  your  form. 
It’ll  look  just  like  a  PictureBox  showing  a  picture  of  a 
bee,  except  that  it’ll  have  animated  flapping  wings. 


Toolbox 


Q  Bee  Simulator  Components 

^  Pointer 


*  BeeControl 
\±i  All  Windows  Forms 
J3_Common  Controls 

^  Pointer 
©  Button 
0  CheckBox 
13  CheckedListBox 
Tf  ComboBox 


Download  tlie  images  lor  this  chapter 
Irom  the  Head  First  Lahs  wehsite: 
www.headifirstlahs.com/hoohs/ 
hJcsharp/ 

,erW  the  o#  passes, 


Si  Form  1  Q0(X 


T*11*  iS  like  a  PicWBox,  but  the 

I?  **  W.  an, mat.cn 
that  wc  II  build  in.  Any  guesses  as  to 

3  t  ass  BeeCohtrol  subclasses?  you  are  here  ► 
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PeeCowtrol  is  UKf  a  PictureDox...  so  let's 
start  by  INHERITING-  from  PicturePox 

Since  eveiy  control  in  the  Toolbox  is  just  an  object,  it's  easy  to  make  a  new 
control.  All  you  need  to  do  is  add  a  new  class  to  your  project  that  inherits  from  an 
existing  control,  and  add  any  new  behavior  you  want  your  control  to  perform. 


We  want  a  control  let's  call  it  a  BeeControl  that  shows  an  animated 
picture  of  a  bee  flapping  its  wings,  but  we  ll  start  with  a  control  that  shows 
a  »0»-animated  picture,  and  then  just  add  animation.  So  we’ll  start  with  a 
PictureBox,  and  then  we’ll  add  code  to  draw  an  animated  bee  on  it. 


/—An  i  rn  ctfe  this! 


Create  a  new  project  and  add  the  four  animation  cells  to  the  project's  resources,  just 
like  you  added  the  Objectville  Paper  Company  logo  to  your  project  way  back  in  Chapter 
I .  Hut  instead  of  adding  them  to  the  form  resources,  add  them  to  the  project's  resources. 


|n  Chapter  I.  a^ed  the  lo^° 

araphtC  to  the  form!*  Resources 
f  ile  This  time  we  re  adding  the 

resources  to  the  project's  global - 

Collection  of  resources,  which  A 

wakes  them  available  to  every  I 

class  in  the  project  (through  the  \ 
Properties  Resources  Collection). 

Take  a  minute  and  flip  back 
to  Chapter  I  to  remind 
yourself  how  you  did  this. 


We’ve  drawn  a  four-cell  bee  animation  that  you  can  import  into  your  resources  that  you 
can  download  from  http:/ / www.headfirstlabs.com/books/hfcsharp/.  Then,  go 
to  the  Resources  page,  select  “Images”  from  the  first  dropdown  at  the  top  of  the  screen, 
and  select  "Add  Existing  File...”  from  the  ‘Add  Resource”  dropdown. 


Bee  animation  l.png  Bee  animation  2. png 


Bee  animation  3. png 


Bee  animation  4.png 


Import  eath  of  these  -mays  into 
your  project's  resources 
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When  you  add  images  or  other  resources  to  the  project’s  Resources  lile,  you  can  access 
them  using  the  Properties  .Resources  class. Just  go  to  any  line  in  your  code  and 
type  Properties .  Re  sour  c^gTvassoon  as  you  do.  the  IntelliSense  pops  up  a 
dropdown  list  that  shows  all  of  the  pictumTvoITVtMuijjorted. 

l  UP  the  proper-ties 

ind  "'etKods  ^  ^e  Class  you  typed  m. 

pictureBoxl . Image  = 

Properties . Resources . Bee_animation_l ; 


R«our<esj,es>c 

la  I  nages  »  J  M3  Rescu  e*  * 


*  X 


Be?  jnrraOcn.l 


This  sets  the  image  used  •for  a 
particular  PictureBox’s  image  (and 
•for  our  starting  image)- 


A 


Bee_anira0:n_3 


stored 
ages  3re  ^ 


Now  add  your  BeeControl!  Just  add  this  BeeControl  class  to  your  project: 

public  class  BeeControl  :  PictureBox  { 

private  Timer  animationTimer  =  new  Timer (); 
public  BeeControl ()  { 


animationTimer. Tick  +=  new  EventHandler (animationTimer_Tick) 
animationTimer . Interval  =  150; 
animationTimer. Start () ; 

BackColor  =  System. Drawing. Color .Transparent; 
BackgroundlmageLayout  =  ImageLayout .Stretch; 


You'll  reed  to  add  a 
using  System  Windows 
Forms  fine  -for  £he 

PnWBm  j«l  T,„„, 

/ 

Here’s  where  you 
initialize  the  timer 
by  instantiating  it, 

'  setting  its  Interval 
property,  and  then 
’  adding  its  tick 
event  handler. 


} 


Each  time  the  timer’s 
tick  event  -fires,  it 
increments  cell,  and 
then  does  a  switch 
based  on  it  to  assign 
the  right  picture  to 
the  Image  property 
(inherited  -from 
PictureBox).  * 


private  int  cell  =  0; 

void  animationTimer_Tick (object  sender,  EventArgs  e)  { 
cell++; 

switch  (cell)  ( 


Once  we  get  back  to  frame  #/, 
well  reset  Cell  back  to  O. 


case  1: 
case  2: 
case  3: 
case  4: 
case  5; 


Backgroundlmage 

Backgroundlmage 

Backgroundlmage 

Backgroundlmage 

Backgroundlmage 


Properties .Resources. Bee_animation_l;  break; 
Properties .Resources .Bee_animation_2;  break; 
Properties .Resources .Bee_animation_3;  break; 
Properties .Resources. Bee_animation_4;  break; 
Properties .Resources. Bee_animation_3;  break; 
default:  Backgroundlmage  =  Properties . Resources. Bee_animation_2; 

cell  =  0;  break;  , 

When  you  change  the  Code  for  a  Control,  you  need  to  rebuild 


When  you  Change  the  Code  +or  a  control,  you  neeu  to 
l/f  your  program  to  make  your  changes  show  up  in  the  designer 


Then  rebuild  your  program.  Go  back  to  the  form  designer  and  look  in  the  toolbox,  the  BeeControl 
is  there.  Drag  it  onto  your  form—  you  get  an  animated  bee! 


you  are  here  ► 
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Create  a  button  to  add  the  PeeControl  to  your  form 

It’s  easy  to  add  a  control  to  a  form-  just  add  it  to  the  Controls  collection.  And  it’s  just 
as  easy  to  remove  from  the  form  by  removing  it  from  Controls.  But  controls  implement 
IDisposable,  so  make  sure  you  always  dispose  your  control  after  you  remove  it. 


Remove  the  BeeControl  from  your  form,  and  then  add  a  button 

Go  to  the  form  designer  and  delete  the  BeeControl  from  the  form.  Then  add  a 
button.  We’ll  make  the  button  add  and  remove  a  BeeControl. 


* 

/slow  do  tliis 
* 


When  yov  add 
a  Control  -to 
■the  Controls 
fcollefctioKi  it 
appears  on 

the  £or» 
immed'atcly- 


Add  a  button  to  and  and  remove  the  bee  control 

Here’s  the  event  handler  for  it: 

BeeControl  control  =  null; 

private  void  buttonl_Click (object  sender,  EventArgs  e) 
if  (control  ==  null)  ( 

control  =  new  BeeControl ()  {  Location  =  new  Point (100,  100) 

Controls .Add (control) ; 

)  else  ( 

Controls . Remove (control) 
control . Dispose ( ) ; 

control  =  null; 


Yom  can  use  an 
object  initializer  to 
set  the  BeeControl 
proper-ties  a-fter 
it’s  instantiated 


1 


AH  you  need  to  do  to  remove  the 
Control  is  remove  it  trom  the 
Controls  Collection  But  make  sure 
you  dispose  it— otherwise  it’ll  keep 
taking  up  resources^ 


) 

Now  when  you  run  your  program,  if  you  click  the  button  once  it'll  add  a  ness  BeeControl  to  the 
form,  ('lick  it  again  and  it'll  delete  it.  It  uses  the  private  control  field  to  hold  the  reference  to 
the  control.  (It  sets  the  reference  to  null  when  there’s  no  control  on  the  form.) 


Toolbox 


&Bee  Simulator  Component  e 

Pointer 
BeeControl 

t  All  Windows  Forms 
-  Common  Controls 

^  Pointer 
©  Button 
0  CheckBox 
13  CheckedListBox 
if  ComboBox 


/ou  can  add  your  own  Behind 

to  the  toolbo.  jwt  ftp  0„pnpt 
by  creating  a  class  that  IjCenej) 

inherits  trom  Control. 

Every  visual  control  in  your 
toolbox  inherits  from  System. 
Windows . Forms . Control.  That 
class  implements  the  has  some 
members  which  should  be  pretty 
familiar  by  now:  Visible,  Width, 
Height,  Text,  Location,  BackColor, 
Backgroundlmage...  all  of  those 
familiar  properties  you  see  in  the 
form’s  Properties  window. 
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Your  controls  need  to  dispose  their  controls,  too! 

There’s  a  problem  with  the  BeeControl.  Controls  need  to  he  disposed  after  The  Control  class  implements 

they’re  done.  But  the  BeeControl  creates  a  new  instance  of  Timer,  which  is  — s  (Disposable,  so  you  need  to  make 

a  control  that  shows  up  in  the  toolbox...  and  it  never  gets  disposed!  That’s  a  sure  every  Control  you  use  <jets 

problem.  Luckily,  it’s  easy  to  fix — just  override  the  Dispose!)  method.  disposed 


Override  the  Dispose()  method  and  dispose  of  the  timer 

Since  BeeControl  inherits  from  a  control,  then  that  control  must  have  a  Dispose))  method.  So  we  can  just 
override  and  extend  that  method  to  dispose  our  timer. Just  go  into  the  control  and  type  override: 


public  class  BeeControl  :  PictureBox  { 

override 


Dispose  (boot  dlsposng) 


^  Dock  {get;  set;  } 

3?  DoubleBuffered  {get;  set;  } 

•  Equalsfobject  obj) 

^  Focused  {get; } 

Font  {get;  set;  } 

^  ForeColor  {get;  set;  } 

GetAccesstaty  ObjectBy  Id  (nt  objected) 

•  GetHashCodeO 

•  GetPreferredSge(System  .Drawing. Size  proposedSze)  v ! 


S 


VVhen  you  type  w™**’ 
inside  a  tlass,  -the  IDE 

pops  up  an  IntelliSense 
Window  with  all  of  the 
methods  you  can  override 

Select  the  D«  W  j 

method  and  it'll  f  '« 


r  „ 


As  soon  as  you  click  on  Dispose)),  the  IDE  will  fill  in  the  method  with  a  call  to  base. Dispose)): 


protected  override  void  Dispose (bool  disposing)  { 
base. Dispose (disposing) ; 

} 


Add  the  code  to  dispose  the  timer 

Since  BeeControl  inherits  from  a  control,  then  (hat  control  must  have  a 
Dispose))  method.  So  we  can  just  override  and  extend  that  method  to  dispose 
our  timer.  Just  add  a  line  to  the  Dispose))  method  that  the  IDE  filled  in  for  you: 


protected  override  void  Dispose (bool  disposing)  { 

animationTimer . Dispose ( ) ; 

base. Dispose (disposing) ; 

1 


Nov\f  the  BeeControl  will  dispose  of  its  timer  as  part 
of  its  own  Dispose))  method.  It  cleans  up  after  itself! 


Kow  your  BeeControl  will 
dispose  of  the  timer  that  it 
Created  in  its  Constructor 
The  IDE  filled  in  a  call  to 
the  PictureBox  base  class’s 
DisposeO  method— leave  it  in 
so  the  PictureBox  can  dispose 
itself,  too. 


Any  control 
that  you  write 
from  scratch 
is  responsible 
for  disposing! 
any  other 
controls  (or 
disposable 
objects)  that  it 
creates. 


you  are  here  ► 
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user  controls  make  it  easy 


A  UserControl  is  an  easy  way  to  build  a  control 

iliere’s  an  easier  way  to  build  your  ow  n  Toolbox  controls.  Instead  of  creating  a  class 
that  inherits  from  an  existing  control,  all  you  need  to  do  is  use  the  IDE  to  add  a 
UserControl  to  your  project.  You  work  with  a  UserControl  just  like  a  form.  You 
can  drag  other  controls  out  of  the  toolbox  and  onto  it — it  uses  the  normal  form 
designer  in  the  IDE.  And  you  can  use  its  events  just  like  you  do  with  a  form.  So  let’s 
rebuild  the  BeeContiol  using  a  UserControl.  Ip 

Right-click  on  BeeControl.es  in  the  IDE  and  rename  it  to  OklBeeControl.es.  The  IDE  w  ill  pop 
up  a  Yes/No  window:  “liiu  arc  renaming  a  file.  Would  you  also  like  to  perform  a  rename  in  this  project 
of  all  references  to  the  code  element  * BeeControI' ?”  this  window  is  asking  if  you  want  to  rename  the 
BeeControI  class  to  Old  BeeContiol,  and  then  change  all  of  the  code  in  the  project  to  reilect  this 
change.  Click  the  “Yes”  button  to  rename  your  BeeControI  to  OldBeeControl. 


'V 

Doffns  a 
* 


O 

O 

o 


Right-click  on  the  project  in  the  Solution  Explorer  and  select  ‘Add  »  User  Control...”  Have  the 
IDE  add  a  user  control  called  BeeControI.  The  IDE  will  open  up  the  new  control  in  the 
form  designer.  Use  •the  arin>atiorTin>ev_TickO  method  (you  II  need  to  rename  it)  and 

the  Cell  -field  from  the  old  bee  Control— but  don't  Copy  anything  else 


Drag  a  Timer  control  onto  your  user  control.  It’ll  show  up  at  the  bottom  of  the  designer,  just  like 
with  a  form.  Use  the  Properties  window  to  set  its  Interval  to  150  and  its  Enabled  to  true. 
Then  double-click  on  it  the  IDE  will  add  its  Tick  event  handler.  Just  use  the  same  Tick  event 
handler  that  you  used  earlier  to  animate  the  fu  st  bee  control. 


Now  update  the  BeeControl’s  constructor: 


public  BeeControI ()  { 

InitializeComponent () ; 

BackColor  =  System. Drawing. Color . Transparent; 
BackgroundlmageLayout  =  ImageLayout . Stretch; 


} 


You  Can  also  do  -this  from  the  Properties 
pa$e  in  the  IDE,  instead  of  using  Code 


Go  back  to  the  button  event  handler  on  the  form.  When  you  renamed 
the  first  BeeControI  to  OldBeeControl,  it  changed  the  form  rode  as 
well.  So  change  the  two  lines  back  to  BeeControI  so  it  uses  your  new 
UserControl  instead  of  the  PicuueBox: 


BeeControI  control  =  null; 
private  void  buttonlClick ( . . . )  f 
if  (control  ==  null)  ( 

control  =  new  BeeControI ()  (  ... 

Now  run  your  program — it  should  work  exactly  the  same  as  before. 
The  button  now  adds  and  removes  your  UserControl-based  BeeControI. 


A  UserControl  is 
an  easy  way  to 
add  a  control  to 
tke  toolkox.  Edit 
a  UserControl  just 
like  a  form— you 
can  drag  otker 
controls  out  of  tke 
toolkox  onto  it, 
and  you  can  use  its 
events  exactly  like 
a  form’s  events. 
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But  I've  been  using 
controls  all  this  time,  and  I've 
never  disposed  a  single  one  of 
them!  Why  should  I  start  now? 


You  didn’t  dispose  your  controls  because  your 
forms  did  it  for  you. 

But  don’t  take  our  word  for  it.  Use  the  IDE’s  search  function  to 
search  your  project  for  the  w  ord  “Dispose”,  and  you'll  find  that 
the  IDE  added  a  method  in  Forml.Designer.es  to  override  the 
Disj  iose()  method  that  calls  its  own  base .  Dispose  ( ) .  When  the 
form  is  disposed,  it  automatically  disposes  everything  in  its 
Controls  collection  so  you  don’t  have  to  worry  about  it.  But  once 
you  start  removing  controls  from  that  collection  or  creating  new 
instances  of  controls  (like  the  Timer  in  the  BeeControl)  outside  of 
the  Controls  collection,  then  you  need  to  do  the  disposal  yourself 


tliere,are  n<? 

Dumb  Questions 


Oj 

Why  does  the  form  code  for  the 
PictureBox-based  BeeControl  work 
exactly  the  same  with  the  UserControl- 
based  BeeControl? 

Because  the  code  doesn't  care  how 
the  BeeControl  object  is  implemented.  It  just 
cares  that  it  can  add  the  object  to  the  form  s 
Controls  method. 

o 

|  double-clicked  on  my 
OldBeeControl  class  in  the  Solution 
Explorer,  and  it  had  a  message  about 
adding  components  to  my  class.  What’s 
that  about? 

When  you  create  a  control  by  adding 
a  class  to  your  project  that  inherits  from 
PictureBox  or  another  control,  the  IDE  does 
some  clever  things.  One  of  the  things  it  does 
is  let  you  work  with  components,  those 
non-visual  controls  like  Timer  and 


OpenFileDialog  that  show  up  in  the  space 
beneath  your  form  when  you  work  with  them. 

Give  it  a  try— create  an  empty  class  that 
inherits  from  PictureBox.  Then  rebuild  your 
project  and  double-click  on  it  in  the  IDE. 

You'll  get  this  message: 

To  add  components  to  your  class,  drag 
them  from  the  Toolbox  and  use  the 
Properties  window  to  set  their  properties. 

Drag  an  OpenFileDialog  out  of  the  Toolbox 
and  onto  your  new  class.  It'll  appear  as 
an  icon.  You  can  click  on  it  and  set  its 
properties.  Set  a  few  of  them  Now  go 
back  to  the  code  for  your  class.  Check  out 
the  constructor— the  IDE  added  code  to 
instantiate  the  OpenFileDialog  object  and  set 
its  properties 


Oj 

When  I  changed  the  properties  in 
the  OpenFileDialog,  I  noticed  an  error 
message  in  the  IDE:  “You  must  rebuild 
your  project  for  the  changes  to  show  up 
in  any  open  designers.”  Why  did  I  get  this 
error? 

Because  the  desginer  runs  your 
control,  and  until  you  rebuild  your  code  it’s 
not  running  the  latest  version  of  the  control. 

Remember  how  the  wings  of  the  bee 
were  flapping  when  you  first  created  your 
BeeControl,  even  when  you  dragged  it  out 
of  the  toolbox  and  into  the  designer?  You 
weren't  running  your  program  yet,  but  the 
code  that  you  wrote  was  being  executed 
The  timer  was  firing  its  Tick  event,  and  your 
event  handler  was  changing  the  picture.  The 
only  way  the  IDE  can  make  that  happen  is  if 
the  code  were  actually  compiled  and  running 
in  memory  somewhere,  So  it’s  reminding  you 
to  update  your  code  so  it  can  display  your 
controls  properly. 
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here's  what  you'll  do... 


The  Tenderer  uses  your  PeeControl  to 
draw  animated  bees  on  your  forms 


W  ith  a  BeeControl  class  and  two  forms,  you  just  need  a  way  to  position 
bees,  move  them  from  one  form  to  the  other,  and  keep  up  with  the  bees. 
You'll  also  need  to  position  flowers  on  the  Field  form,  although  since 
flowers  don’t  move,  dial’s  pretty  simple.  All  of  this  is  code  that  we  can 
put  into  a  new  class,  Renderer.  Here’s  what  that  class  does: 


The  stats  form  will  be  the  parent  of  the  hive  and  field  forms 

I  he  first  step  in  adding  graphics  to  the  Beehive  Simulator  will  he  adding  two 
forms  to  the  project.  You’ll  add  one  called  Hive  Form  (to  show  the  inside  of 
the  hive)  and  one  called  FieldForm  (which  will  show  the  field  of  flowers).  Then 
you'll  add  lines  to  the  main  form's  constructor  to  show  its  two  child  forms  to  tell 
Windows  that  the  stats  form  is  their  owner: 


Y<*  II  want  the  hive  and 
■field  forms  "linked"  to 
the  stats  form — that  does 
useful  things  like  minimizing 
the  hive  and  field  forms 
when  you  minimize  the  stats 
form  You  can  do  this  by 
telling  Windows  that  the 
stats  form  is  their  owner. 


public  Formlf)  { 

//  other  code  in  the  Forml  constructor 
hiveForm. Show (this) ; 
fieldForm. Show (this)  ; 


Every  form  object  has  a  ShowO 
method  |f  you  want  to  set  another 
form  as  its  owner,  iust  pass  a 
reference  to  that  form  to  ShowO. 


The  renderer  keeps  a  reference  to  the  world  and  each  child  form 

At  the  very  top  of  the  Renderer  class  you’ll  need  a  few  important  fields.  The 
class  has  to  know  the  location  of  each  bee  and  flower,  so  it  needs  a  reference  to  the 
World.  And  it’ll  need  to  add,  move,  and  remove  controls  in  the  two  forms,  so  it 
needs  a  reference  to  each  of  those  forms: 


public  class  Renderer  {  "T  Start  your  Renderer 

private  World  world;  class  wrth  these  lines, 

private  HiveForm  hiveForm;  C  We’ll  add  to  this  class 
private  FieldForm  fieldForm;  throughout  the  chapter. 


The  renderer  uses  dictionaries  to  keep  track  of  the  controls 

World  keeps  track  of  its  Bee  objects  using  a  List<Bee>  and  a  List<Flower>  to  store 
its  flowers.  The  renderer  needs  to  be  able  to  look  at  each  of  those  Bee  and  Flower  objects 
and  figure  out  what  BeeControl  and  PictureBox  they  correspond  to — or.  if  it  can't 
find  a  corresponding  control,  it  needs  to  create  one.  So  here’s  a  perfect  opportunity  to  use 
dictionaries.  So  we’ll  need  two  more  private  fields  in  Renderer: 


private  Dictionary<Flower,  PictureBox>  flowerLookup  = 

Cnew  Dictionary<Flower,  PictureBox> () ;  ^ _ . 

private  Dictionary<Bee,  BeeControl>  beeLookup  =  / 

T*  new  Dictionary<Bee,  BeeControl>  ( ) ;  These  two  dictionary  Col  eC 

These  dictionaries  become  one-to-one 

mappings  between  a  bee  or  flower  and  e,  •  ^Id 


I  ntJt  - -  -  i 

let  the  renderer  store  exactly 
one  Control  for  each  bee  or 
flower  in 
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The  feeder*  i,  «ti,5  „  ft,  ( 

fV"''  ■"  *)«*>  b-lt  »  the 

last  Chapter  w  the  simulator. 


The  bees  and  flowers  already  know  their  locations 

There's  a  reason  we  stored  each  bee  and  flower  location  using  a  Point.  Once  we  have  a 
Bee  object,  we  can  easily  look  up  its  BeeControl  and  set  its  location. 


beeControl  =  beeLookup [ bee ] ; 
beeControl. Location  =  bee. Location; 


For  each  bee  or  f|£ 


cacn  oee  or  +  lower,  we  ea«  look  up  the 

atchrng  Control.  Then,  set  that  Control's 
l°Mt.on  to  match  the  location  of  the  bee 
or  -Hower  object. 


If  a  bee  doesn't  have  a  control,  the  renderer  adds  it  to  the  hive  form 

Its  easy  enough  for  the  renderer  to  figure  out  if  a  particular  bee  or  flower  has  a  control.  If  the 
dictionary’s  ContainsKey  ( )  method  returns  false  for  a  particular  Bee  object,  that  means 
there’s  no  control  on  the  form  for  that  bee.  So  Renderer  needs  to  create  a  BeeControl,  add  it  to 
the  dictionary,  and  then  add  the  control  to  the  form.  (It  also  calls  the  control’s  BringToFront  ( ) 
method,  to  make  sure  the  control  doesn’t  get  hidden  behind  the  flower  PictureBoxes): 


if  ( IbeeLookup. ContainsKey (bee) )  { 

if  ( IbeeLookup. ContainsKey (bee) )  ( 

beeControl  =  new  BeeControl ()  <  Width  = 
beeLookup. Add (bee,  beeControl); 
hiveForm . Cont  rols . Add (beeCont  rol ) ; 
beeControl . BringToFront ( ) ; 


else 

beeControl  =  beeLookup [bee] 


m  Sr -if&n ^ 


one  uses  a  Bee  object  as  a  key.  The  renderer 
Deeds  to  know  which  BeeControl  on  the  form  belonas 
to  a  particular  bee.  So  it  looks  up  that  bee's  object 
m  the  dictionary,  which  spits  out  the  Correct  Control, 
flow  the  renderer  can  move  rt  around. 


Bring  ToF 


40,  Height  =40  }; 

Contains^/)  tells  us  if  the  bee 
exists  m  the  dictionary.  |f  not,  then 

**  heed  **d  bee,  along  with  a 
Corresponding  Control. 

tO  ensures  the  bee 


appears  "on  top  of''  any  flowers  on 
the  FieldForm,  and  on  -top  of  the 
background  of  the  HiveForm. 
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let’s  get  started! 


Add  the  hive  and  field  forms  to  the  project 


Now  you  need  forms  to  put  bees  on.  So  start  with  your  existing  Beehive 
Simulator  project,  and  use  “Add  »  Existing  Item...”  to  add  your  new 
BeeControl  user  control.  Then  add  two  more  W  indows  forms  to  the  project  by 
right-clicking  on  the  project  in  the  Solution  Explorer  and  choosing  “Windows 
Form...”  from  the  Add  menu.  If  you  name  the  files  HiveFbrm.es  and  FieldForm.es, 
the  IDE  will  automatically  set  their  Name  properties  to  HiveForm  and  FieldForm.  the  Properties  window 
You  already  know  that  forms  are  just  objects,  so  HiveForm  and  FieldForm  are 
really  just  two  more  classes. 


This  is  a  PictureBo*  Control  with 
its  Backgroundlmage  set  to  the 
outside  hive  picture  When  you  load 
the  hive  pictures  into  the  Resource 
Designer,  they’ll  show  up  in  the  l'st^ 
of  resources  when  you  click  the  — 
button  ne*t  to  Background  I  mage  in 


Make  sure 
you  resite 
both  -forms 
so  they  look 
like  these 
screenshots- 


Set  the  form's  Backgrounding 
property  to  the  inside  hive  picture 

Figure  out  where  your  locations  are 


/ou  II  need  the  inside  and  outside  hive 
images— "Hive  (inside).png"  and  "Hive 
^outide)  png"—  loaded  m to  your  resources. 
Then  add  these  two  forms.  £et 
Wm  s  rormjWderStyle  property  to 
hxedSmgle  (so  the  user  can't  resize  it), 
the  C£niro[Bo2_  property  to  false  (to  take 
away  its  minimize  and  maximize  Controls), 
a*d  imposition  to  Manual  (so  its 

Location  property  is  settable). 


Remember/gotothePro^rti«window!ciickon  the  lightning-bolt 

to  bring  up  the  Events  window,  scroll  down  to  the  MouseClick  row 
double-click  on  it  The  IDE  will  add  the  event  handler  for  you 


icon 
and  double 


rlieStN _ l 


You  need  to  figure  out  where  the  hive  is  on  your  FieldForm.  Using  the  Prope 
window,  create  a  handler  for  the  MouseClick  event,  and  add  this  rode: 

private  void  Forml_MouseClick (object  sender,  MouseEventArgs  e) 
MessageBox. Show (e. Location. ToStringO ) ; 

1 


Now  you  can  run  the  form,  and  click  on  the  location  of  the  hive.  That  wi 
set  of  coordinates  for  your  hiv  e  on  the  field. 


give  you  a 


Add  the  same  handler  to  HiveForm,  and  run  it.  Then,  by  clicking,  get  the  coordinates 
of  the  exit,  the  nursery,  and  the  honey  factory.  Using  all  these  locations,  you  can  update 
the  ResetLocations  ( )  method  you  wrote  in  the  Hive  class  in  the  last  chapter: 

private  void  ResetLocations () 

{ 

locations  =  new  Dictionary<string,  Point>(); 
locations .Add ("Entrance",  new  Point(600,  100)); 
locations .Add ("Nursery",  new  Point (95,  174)); 
locations .Add ("HoneyFactory",  new  Point(157,  98)) 
locations .Add ("Exit",  new  Point  (194,  213^) ; 

These  are  -the  Coordinates  that  worked  for  us,  but  if  you're  forms 
a  little  bigger  or  smaller,  your  Coordinates  will  be  different- 
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Remove  the  mouse  click 
handler  when  you’re  done ... 
you  just  needed  it  to  get  the 
locations  on  your  forms. 


Build  the  (tenderer 


Here’s  che  complete  Renderer  class.  The  main  form  calls  this 
class’s  Render  ( )  method  right  after  it  calls  World .  Go  ( )  to  draw 
the  bees  and  flowers  on  the  forms.  You'll  need  to  make  sure  that  the 
flower  graphic  (Flower  .png)  is  loaded  into  the  project,  just  like 
the  animated  bee  images. 


public  class  Renderer  { 
private  World  world; 
private  HiveForm  hiveForm; 
private  FieldForm  fieldForm; 


the  world  and  the  two  forms  t 

draws  the  bees  on 


private  Dictionary<Flower,  PictureBox>  flowerLookup  = 
new  Dictionary<Flower,  PictureBox> () ; 
private  List<Flower>  deadFlowers  =  new  List<Flower> ( ) ; 

private  Dictionary<Bee,  BeeControl>  beeLookup  = 
new  Dictionary<Bee,  BeeControl> ( ) ; 
private  List<Bee>  retiredBees  =  new  List<Bee>(); 


controls  and  graphics 

^itf^ields  in  the  renderer 
are  private  because  no 
other  class  needs  to  update 
•to  any  of  its  properties 
It’s  fully  encapsulated  The 
world  just  calls  RenderO 
to  draw  the  world  to  the 
forms,  and  ResetO  bo  clear 
bhe  Conbrols  on  bhe  forms 
if  it  needs  to  reset 


IXt!?  t  ?"  J"d  Fw  <*>•* 

to  k«p  brack  of  every  bee  and 

ihR  e  rld  U'  « 

hcbureBox  bo  display  each  f|OWer 
and  a  BeeConbrol  bo  display  each  bee 
I  he  renderer  uses  bhese  dicbionaries 

ow  TrT\  bee  Wfci is 

own  BeeConbrol  or  PiebureBo 


public  Renderer (World  world,  HiveForm  hiveForm,  FieldForm  fieldForm)  ( 
this. world  =  world; 
this . hiveForm  =  hiveForm; 
this . fieldForm  =  fieldForm; 

}  The  bimer  on  bhe  main  form  bhab  runs  bhe 

,  animation  Calls  the  RenderO  method,  which 
public  void  RenderO  I  updates  the  bees  and  the  flowers,  and  then 

DrawBees  ( ) ;  cleans  out  its  dictionaries 

DrawFlowers () ; 

RemoveRetiredBeesAndDeadFlowers () ; 

) 


?ox 

f 

I^Vhen  a  flower  dies 
o^  a  bee  rebires,  ib 
the  deadFlowers 
and  retiredBees  lisbs 
to  clean  out  the 
dictionaries. 


public  void  ResetO  I 

foreach  (PictureBox  flower  in  flower Lookup. Values)  { 
fieldForm. Controls .Remove (flower) ; 
flower. Dispose () ; 


) 

foreach  (BeeControl  bee  in  beeLookup. Values) 
hiveForm. Controls .Remove (bee) ; 
fieldForm. Controls .Remove (bee) ; 
bee. Dispose () ; 

) 

f lowerLookup. Clear ( )  ; 
beeLookup. Clear () ; 

) 


-  — -  -  ■  w  ’  w  vqii* 

the  RemoveAllControlsO  method  to 
Completely  clear  out  the  Controls  on 
the  two  forms.  |t  finds  all  of  the 
l\^  Controls  in  each  of  its  two  dictionaries 
and  removes  them  from  the  forms, 
calling  DisposeO  on  each  of  them.  Then 
it  clears  the  two  dictionaries. 
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here's  the  tenderer  class 

It  takes  two  foreach  loops  to  draw  the  -flowers.  The  first  looks 
for  mm  flowers  and  adds  their  PidtureBoy.es  The  second  looks 
for  dead  flowers  and  removes  their  PietureBoxes 

private  void  DrawFlowersO  { 

foreach  (Flower  flower  in  world. Flowers) 

if  (! flowerLookup.ContainsKey (flower) )  ( 

PictureBox  flowerControl  =  new  PictureBoxO  { 

DrawFlowersO  uses  the  Width  =  45, 

Location  property  in  Height  =  55, 

the  Flower  object  to  Image  =  Properties. Resources. Flower, 
set  the  PictureBox's  ^  SizeMode  =  PictureBoxSizeMode.Stretchlmage, 
location  on  the  form.  Location  =  flower .  Location 
); 


The  first  foreach  loop  uses 
the  f  lowerLookup  dictionary 
to  check  each  flower  to 
see  if  its  (jot  a  Control  on 
the  form  |f  it  doesn't,  it 
Creates  a  new  PictureBox 
usinj  an  object  initializer, 
adds  it  to  the  for  m,  and 
then  adds  it  to  the 
flowerLookup  dictionary 


) 


flowerLookup. Add (flower,  flowerControl) 
fieldForm. Controls .Add (flowerControl) ; 


( 


The  second  foreach  loop 
looks  for  any  PictureBox  in 
the  flowerLookup  dictionary 
that’s  no  longer  on  the  form 
and  removes  it- 


foreach  (Flower  flower  in  flowerLookup. Keys) 
if  (! world. Flowers .Contains (flower) )  { 

PictureBox  flowerControlToRemove  =  flowerLookup [flower) ; 
fieldForm. Controls .Remove (flowerControlToRemove) ; 
f lowerControlToRemove. Dispose  0 ;  . 

deadFlowers .Add (flower) ;  After  it  removes  the  PictureBox,  it  calls  its 

DisposeO  method  Then  it  adds  the  Flower 
object  to  deadFlowers  so  it'll  jet  cleared  later 


) 


private  void  DrawBeesO  { 

BeeControl  beeControl; 
foreach  (Bee  bee  in  world. Bees)  ( 

beeControl  =  GetBeeControl (bee) ; 
if  (bee . InsideHive)  { 

if  (fieldForm. Controls. Contains (beeControl) ) 
MoveBeeFromFieldToHive (beeControl) ; 

)  else  if  (hiveForm. Controls. Contains (beeControl) ) 
MoveBeeFromHiveToField (beeControl,  bee) ; 


DrawBeesO  also  uses  two  breach 
oops,  and  it  does  the  same  basic 
thinjs  as  DrawFlowersO.  But 
it  s  a  little  more  Complex,  so  we 
split  some  of  its  behavior  out 
into  separate  methods  to  make  it 
easier  to  understand 


beeControl. Location  =  bee. Location; 


) 


tl 

* 

^  b 


DnCe  the  BeeControl 
is  removed,  we  need 
to  Call  its  DisposeO 
method— the  user 
Control  will  dispose  of 


DrawBeesO  checks  if  a  bee  is  in 
the  hive  but  its  Control  is  on  the 
FieldForm,  or  vice  versa  It  uses 
wo  extra  methds  to  move  the 
BeeControls  between  the  forms. 


foreach  (Bee  bee  in  beeLookup.Keys)  ( 

if  ( (world. Bees. Contains (bee) )  { 

beeControl  =  beeLookup[bee] ; 

if  (fieldForm. Controls .Contains (beeControl) ) 

fieldForm. Controls .Remove (beeControl) ; 

if  (hiveForm. Controls. Contains  (beeControl) )  The  second  foreach  loop  works 

.  ,  .  -  hiveForm. Controls. Remove (beeControl) ;  just  like  m  DrawFlowersO 

its  timer  -ror  us.  1  n.  .  _  .  ,  _  •  , ,  _ _ _  *  ,  ,  ' 

V - ^  beeControl .  Dispose  ( ) ;  except  it  needs  to  remove  the 

ret i redBees . Add ( bee ) ;  BeeControl  fr  Om  the  riftht 

I  )  form. 
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You’ll  need  to  make  sure  you’ve  got  using  System. Drawing 
and  using  System. Windows  .  Forms  at  the  top  of  the 
Renderer  class  file. 


^etBeeControK)  looks  up  a  bee  in  the 
beeLookup  dictionary  and  returns  it-  |f 
it’s  not  there,  it  Creates  a  new  x  °r0 
BeeControl  and  adds  it  to  the  hive  -form 
(sinee  that’s  where  bees  are  bom) 


Don 

the 


private  BeeControl  GetBeeControl (Bee  bee)  { 

BeeControl  beeControl; 
if  (! beeLookup. ContainsKey (bee) )  { 

beeControl  =  new  BeeControl ()  {  Width  =  40,  Height  =  40  }; 
beeLookup. Add (bee,  beeControl); 
hiveForm. Controls .Add (beeControl) ; 
beeControl .BringToFront () ; 

} 

else 

beeControl  =  beeLookup [bee] 
return  beeControl; 


t  forget  that 
'  means  NOT 


) 


MoveBeeFr  On*  HiveToFieldO  takes  a  specific 
BeeControl  out  of  the  hive  form's  Controls 
Collection  and  adds  it  to  the  field  form's 


Collectioi 
Controls  Collection 


private  void  MoveBeeFromHiveToField (BeeControl  beeControl,  Bee  bee)  { 
hiveForm. Controls .Remove (beeControl) ; 
beeControl . Size  =  new  Size(20,  20); 
fieldForm. Controls . Add (beeControl ) ; 
beeControl . BringToFront ( ) ; 


) 


^  The  bees  on  the  f  ield  form  are  smaller  than 
the  ones  on  the  hive  form,  so  the  method 
needs  to  change  BeeControl’s  Size  property 


private  void  MoveBeeFromFieldToHive (BeeControl  beeControl)  { 
fieldForm. Controls. Remove (beeControl) ; 
beeControl. Size  =  new  Size  (40,  40);  MoveBeeFromFieldToHive^)  moves  a 

hiveForm. Controls. Add  (beeControl) ;  BeeControl  back  to  the  hive  form. 

beeControl. BringToFront  () ;  ^  mal<e  *t  bigger  again 

) 


private  void  RemoveRetiredBeesAndDeadFlowers ( ) 

foreach  (Bee  bee  in  retiredBees) 
beeLookup . Remove (bee) ; 
retiredBees . Clear ( ) ; 

foreach  (Flower  flower  in  deadFlowers) 
flowerLookup. Remove (flower) ; 
deadFlowers . Clear  ( ) ; 


) 


Whenever  DrawBeesO  and  DrawFlowersO 
found  that  3  flower  or  bee  was  no  longer 
in  the  world,  it  added  them  to  the 
deadFlowers  and  retiredBees  lists  to  be 
removed  at  the  end  of  the  frame 


f 


After  all  the  Controls  are  moved  around, 
the  renderer  calls  this  method  to  clear 
any  dead  flowers  and  retired  bees  out  of 
the  two  dictionaries 
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Now  connect  the  wain  forw  to  your 
two  new  forws,  HiveForw  and  Field  Forw 

It’s  great  to  have  a  Renderer,  but  so  far,  there  aren’t  any  forms  to  render 
onto.  We  can  fix  that  by  going  back  to  the  main  Form  class  (probably 
called  Forml),  and  making  some  code  changes: 


public  partial  class  Forml  :  Form  { 

HiveForm  hiveForm  =  new  HiveForm ( ) ; 
FieldForm  fieldForm  =  new  FieldForm() ; 
Renderer  renderer; 


TVvW  ti  °!  the  oiUer  U 


an 

ms. 


//  the  rest  of  the  fields 


public  Forml ()  { 

InitializeComponent () ; 


_ Move  -the  Code  to  instantiate  the  lA/brld 

into  the  ResetSimulatorO  method 


MoveChildForms () ; 
hiveForm . Show ( this ) ; 
fieldForm. Show (this) 
ResetSimulator ( ) ; 

//  The^rest  of  the  code 


■  The  form  passes  a  reference 
to  itself  into  Form  ShowO  so 
it  becomes  the  parent  form 


stays  the  same 

Everything  else  that  used  to  be  m 
the  Constructor  will  be  moved  to 
the  ResetSimulatorO  method 


private  void  MoveChildForms ()  { 

hiveForm. Location  =  new  Point (Location .X  +  Width  + 
fieldForm. Location  =  new  Point (Location. X, 

Location. Y  +  Math. Max (Height,  hiveForm. Height)  + 

} 


■  The  main  -form  s  Constructor 
moves  the  two  Child  forms 
in  place,  then  displays  them 
Then  it  calls  ResetSimulatorO, 
which  instantiates  Renderer 


public  void  RunFrame (object  sender, 
framesRun++; 
world. Go (random) ; 

renderer . Render ( ) ;  ^ 

//  previous  code 

} 


EventArgs  e)  { 


10,  Location. Y); 

^  This  Code  moves  the  two 
forms  so  that  the  hive 
form  is  ne*t  to  the  main 
stats  form  and  the  field 
form  is  below  both  of  then 


my 


Adding  this  one  line  to  RunFrame  makes  the 
simulator  update  the  graphics  after  each  time 
the  world  s  qo 0  method  is  called 
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private  void  Forml_Move (object  sender,  EventArgs  e) 

MoveChildForms  ( )  ;  ^  ^  Events  ^tton  ,n  the  Properties 

...  p.  .  ,  .  Cmdow  to  add  the  Move  event  handler. 

Make  sure  youve  set  the  Field  and 

hive  forms’  Start  Position  property  to 

Manual,  or  else  MoveChildFcrmsO  won't 

work. 

Chapter  13 


The  Move  event  «  fired 
every  time  the  main 
form  is  moved  Calling 
MoveChildFormsO  makes 
sure  the  Child  forms 
always  move  along  with 
the  main  form. 


controls  and  graphics 


IWs  where  ^  create  new  instances  of 
the  World  and  Renderer  classes,  which 
resets  the  simulator. 


private  void  ResetSimulator ()  { 
f ramesRun  =  0 ; 

world  =  new  World (new  Bee .BeeMessage (SendMessage) ) ; 
renderer  =  new  Renderer (world,  hiveForm,  fieldForm) 

} 


private  void  reset_Click (object  sender,  EventArgs  e) 

renderer . Reset () ; 

ResetSimulator () ; 

if  (! timerl .Enabled) 

toolStripl . Items [0] .Text  =  "Start  simulation"; 

} 


The  Reset  ^tton  needs  to 
M||  ResetO  to  clear  cut  all 

the  BeeControls  and  flower 
p,eture&o*es,  and  then  reset 
the  simulator* 


private  void  openToolStripButton  Click (object  sender,  EventArgs  e)  { 
//  The  rest  of  the  code  in  this  button  stays  exactly  the  same. 


renderer . Reset ( ) ; 

renderer  =  new  Renderer (world,  hiveForm,  fieldForm) ; 

} 

) 

Finally,  you  II  need  to  add  Code  to 
the  Open  button  on  the  ToolStrip 
to  use  the  ResetO  method  to 
remove  the  bees  and  flowers  from 
the  two  forms  Controls  Collections 
and  then  Create  a  new  renderer 
usm3  the  newly  loaded  world. 

there. are  no 

Dumb  Questions 


Qj  I  saw  that  you  showed  the  form  using  a  Show  ( )  method, 
but  I  don’t  quite  get  what  was  going  on  with  passing  this  as  a 
parameter. 

This  all  comes  down  to  the  idea  that  a  form  is  just  another 
class.  When  you  display  a  form  you're  just  instantiating  that  dass 
and  calling  its  Show  ( )  method.  There's  an  overloaded  version  of 
Show  ( )  that  takes  one  parameter,  a  parent  window  When  one 
form  is  a  parent  of  another,  it  causes  Windows  to  set  up  a  special 
relationship  between  them— for  example,  when  you  minimize  the 
parent  window,  it  automatically  minimizes  all  of  that  form's  child 
windows,  too, 


Q: 


•  Can  you  alter  the  preexisting  controls  and  muck  around 
with  their  code? 


No,  you  can't  actually  access  the  code  inside  the  controls 
that  ship  with  Visual  Studio.  However,  every  single  one  of  those 
controls  is  a  class  that  you  can  inherit,  just  like  you  inherited  from 
PictureBox  to  create  your  BeeControl.  If  you  want  to 
add  or  change  behavior  in  any  of  those  controls,  you  add  your  own 
methods  and  properties  that  manipulate  the  ones  in  the  base  class 


you  are  here  ► 
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something's  wrong 


Test  drive...  ahem...  buzz 

Compile  all  your  code,  chase  down  any  errors  you’re 
getting,  and  run  your  simulator. 


Your  bees  should  be  ha^ty 
fla??.ngthe. *  *#'*"' 

4? 


Try  ehanging  -the 
Constants  on  your 
simulator,  and  seeing  ho* 
the  tenderer  handles 
more  bees  or  -flowers 
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looks  great,  but  something's  not  quite  right... 

Look  closely  al  Uie  bees  buzzing  around  the  hive  and  the  flowers,  and  you’ll 
notice  some  problems  with  the  way  they’re  being  rendered.  Remember  how  you 
set  each  BeeControl’s  BackColor  property  to  Color  .  Transparent? 
Unfortunately,  that  wasn’t  enough  to  keep  the  simulator  front  having  some 
problems  which  arc  actually  pretty  typical  of  graphics  programs. 


There  are  some  serious  performance  issues 

Did  you  notice  how  the  whole  simulator  slows  down  when  all  the  bees  are  inside  the  hive? 
If  not,  try  adding  more  bees  by  increasing  the  constants  in  the  World  class.  Keep  your 
eye  on  llte  frame  rate — add  more  bees,  and  it  starts  to  drop  significantly. 


The  flowers'  backgrounds  aren't  really  transparent 

And  there’s  anoUter,  completely  separate  problem.  When  we  sat  ed  die  graphics  files  for 
the  flowers,  we  gave  them  transparent  backgrounds.  But  while  that  made  sure  that  each 
flower’s  background  matched  the  background  of  the  form,  it  doesn’t  look  so  nice  when 
flowers  overlap  each  other.  _ 


] 

Mie*  one  PicfcueeBo*  overlaps 
another,  C$  draws  the 
transparent  pixels  so  they  match 
the  form,  not  the  other  Control 
that  it  overlaps,  causing  weird 
rectangular  "cut-outs"  any  time 
two  flowers  overlap. 


,en  you  set  a  Pd>refWs 
tk^round  Color  to  Transparent,  't 
aws  any  transparent  p<*els  the 
aae  so  they  match  the  background 
:  the  form  which  isn't  always  the 
jht  thin^  to  do 


The  bees'  backgrounds  aren't  transparent,  either 

It  turns  out  that  Color .  Transparent  really  docs  have  some  limitations.  When  the 
bees  are  holering  over  the  flowers,  the  same  “cut-out”  glitch  happens.  Transparency 
works  a  little  better  with  the  hive  form,  where  the  form’s  background  image  does  show 
through  the  transparent  areas  of  of  the  bee  graphics.  But  when  the  bees  overlap,  the 
same  problems  occur.  And  if  you  watch  closely  as  the  bees  move  around  the  hive,  you’ll 
see  some  glitches  where  the  bee  image  are  sometimes  distorted  when  they  move. 


you  are  here  ► 
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we  bit  off  more  than  the  program  could  chew 


Let's  take  a  closer  look  at  those  performance  issues 

Hat  h  bee  picture  you  downloaded  is  big.  Really  big.  Pop  one  of  diem  open  in  Windows 
Picture  Viewer  and  see  for  yourself.  That  means  the  PictureBox  needs  to  shrink  it  down 
every  time  it  changes  the  image,  and  sealing  an  image  up  or  down  takes  time.  The  reason 
the  bees  move  a  lot  slower  when  there’s  a  lot  of  them  flying  around  inside  the  hive  is 
because  the  inside  hive  picture  is  HUGE.  And  when  you  made  the  background  for  die 
BeeControl  transparent,  it  needs  to  do  double  work:  first  it  has  to  shrink  the  bee  picture 
down,  and  then  it  needs  to  shrink  a  portion  of  the  form’s  background  down  so  that  it  can 
draw  it  in  the  transparent  area  behind  the  bee. 


Bee  animation  l.png 


The  graphics  files  for  the 
bees  are  really  BIG.  When  the 
PictureBox  needs  to  scale  the 
picture  down  to  size  every  time  it 
displays  a  new  animation  frame. 
That  takes  a  lot  of  time... 


The  inside  hive  picture  is  huge 
Every  time  a  bee  -flies  in  front 
of  it,  its  PictureBox  needs  to 
scale  it  down  to  the  site  of  the 
Control  It  needs  to  do  that 
to  show  part  of  the  picture 
any  place  the  bee  picture's 
transparent  background  lets  it 
show  through 


The  bee  picture  is 
really  big,  and  the 
PictureBox  needs 
time  to  shrink  it 
down  every  time 
it  displays  a  new 
animation  frame 


Hive  (Inside). png 
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...so  all  we  need  to  do  to  speed  up  the  simulator’s  performance 
is  to  shrink  down  all  the  pictures  before  we  try  to  display  them. 


controls  and  graphics 


All  we  need  to  do  to  speed  up  the  graphics  performance  is  add  a  method 
to  the  Tenderer  that  scales  any  image  to  a  different  size.  Then  we  can 

resize  each  picture  once  when  it’s  loaded,  and  only  use  the  scaled 
down  version  in  the  bee  control  and  for  the  hive  form’s  background. 


% 


* 


Add  the  Resizelmage  method  to  the  Tenderer 

All  of  the  pictures  in  your  project  (like  Properties  .Resources  .  Flower)  are  stored  as 
Bitmap  objects.  Here’s  a  statir  method  that  resizes  bitmaps — add  it  to  the  Renderer  class: 


Do  thh 


* 


public  static  Bitmap  Resizelmage (Bitmap  picture,  int  width,  int  height)  { 
Bitmap  resizedPicture  =  new  Bitmap (width,  height); 
using  (Graphics  graphics  =  Graphics. Fromlmage (resizedPicture) )  { 
graphics . Drawlmage (picture,  0,  0,  width,  height); 


) 

return  resizedPicture; 


V  We'll  -take  a  closer  look  at  what  this  graphics  object  is 
and  how  this  method  works  in  the  ne*t  few  pays 


Q)  Add  this  ResizeCells  method  to  your  BeeControl 

Your  BeeControl  can  store  its  own  Bitmap  objects  an  array  of  four  of  them.  Here's  a  control  that’ll 
populate  that  array,  resizing  each  one  so  that  it’s  exactly  the  right  size  for  the  control: 


private  Bitmap!]  cells  =  new  Bitmap [4]; 
private  void  ResizeCells ()  ( 

cells[0]  =  Renderer .Resizelmage (Properties .Resources .Bee_animation_l ,  Width,  Height); 
cells(l]  =  Renderer .Resizelmage (Properties .Resources .Bee_animation_2,  Width,  Height); 
cells[2]  =  Renderer .Resizelmage (Properties .Resources .Bee_animation_3,  Width,  Height); 
cells[3]  =  Renderer. Resizelmage (Properties. Resources. Bee_animation_4,  Width,  Height); 

> 

Change  the  switch  statement  so  that  it  uses  the  cells  array,  not  the  resources 

The  BeeControl’s  l  ick  event  handler  has  a  switch  statement  that  sets  its  Background  Image: 


Backgroundlmage  =  Properties .Resources . Bee_animation_l; 

Replace  Properties .  Resources .  Bee_animation_l  with  cells  [0] .  Now  replace  the  rest  of  the 
case  lines,  so  that  case  2  one  uses  cells  [  1  ] ,  case  3  uses  cells  [2 ] ,  case  4  uses  cells  [3] ,  case  5 
uses  cells  [2  ] ,  and  the  default  case  uses  cells  [  1  ] .  That  way  only  llte  resized  image  is  displayed. 

Q)  Add  calls  to  ResizeCells()  to  the  BeeControl 

You'll  need  to  add  two  calls  to  the  new  ResizeGellsQ  method.  First,  add  it  to  the  bottom  of  the 
constructor  and  change  the  BackgroundlmageLayout  property  to  None.  Then  go  back 
to  the  IDE  designer  by  double-clicking  on  the  BeeControl  in  the  Propcritcs  window.  Go  over  to  the 
Events  page  in  the  Properties  window  (by  clicking  on  the  lightning  bolt  iron),  scroll  down  to  Resize, 
and  double-click  on  it  to  add  a  Resize  event  handler.  Make  the  new  Resize  event  handler  call 
ResizeGells()  too  that  way  it'll  resize  its  animation  pictures  every  time  the  form  is  resized. 


Set  the  form’s  background  image  manually 

Go  to  the  Properties  window  and  set  the  hive  form’s  background  image  to  (none) .  Then  go  to  its 
constructor  and  set  the  image  to  one  that’s  sized  properly. 


public  partial  class  HiveForm  :  Form  ( 
public  HiveForm ()  { 

InitializeComponent () ;  _ 

Backgroundlmage  =  Renderer  .Resizelmage  (  has  the  dimensions  of  its  display  area" 
Properties. Resources. Hive_  inside_,  \  '  ' 

ClientRectangle .Width,  ClientRectangle. Height) ;  ✓ _ s 


/our  form  has  a  ClientRectangle 
property  that  contains  a  Rectangle  which 


) 


) 


Now  run  the  simulator — it’s  much  faster! 


you  are  here  * 
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digging  deeper  into  graphics 


You  resized  your  Bitmaps  using  a  graphics  object 

Let’s  take  a  closer  look  at  that  Resizelmage  ( )  method  you  added  to  the 
tenderer.  The  first  thing  it  does  is  create  a  new  Bitmap  object  that’s  the  size  that 
the  picture  will  be  resized  to.  Then  it  uses  Graphics  .  Fromlmage  ( )  to  create 
a  new  Graphics  object.  It  uses  that  Graphics  object’s  Drawlmage  ( )  method 
to  draw  the  picture  onto  the  Bitmap.  Notice  how  you  passed  the  width  and 
height  parameters  to  Drawlmage  ( )  that’s  how  you  tell  it  to  scale  the  image 
down  to  the  new  size.  Finally  you  returned  the  new  Bitmap  you  created,  so  it  can 
be  used  as  the  form’s  background  image  or  one  of  the  four  animation  cells. 


f'orms  it'd  Controls  Wave  a 
Creatc^raphiCsO  method 

that  returns  a  new  graphics 
object  You'll  see  a  lot  more 
about  that  shortly 


You  pass  a  picture  into  the 
method,  along  with  a  new 
width  and  height  that  it'll 
be  resired  to- 


public  static  Bitmap  Resizelmage (Bitmap  picture,  int  width,  int  height)  { 
Bitmap  resizedPicture  =  new  Bitmap (width ,  height); 
using  (Graphics  graphics  = 

graphics .Drawlmage (picture,  0,  0,  width, 

»  * 

return 


) 


Graphics . Fromlmage (resizedPicture) )  { 

height) ;  ^ 

The  Fromlmag eO  method  returns  a  new  graphics  object  that  let 
you  draw  graphics  onto  that  .mage  Take  a  minute  and  use  the  IDE 
resizedPicture ;  to  look  at  the  methods  in  the  fra ph.cs  class  When  you 

prawImageO,  ,t  copies  the  .mage  into  the  resizedP.cture  bitmap  at  t 
location  ?0,  0)  and  scaled  to  the  width  and  height  parameters.. 


Let's  see  image  resizing  in  action 


Drag  a  button  onto  the  Field  form  and  add  this  code.  It  creates  a  new  Picture B<  >x 
control  that’s  100  x 100  pixels,  setting  its  border  to  a  black  line  so  you  can  see  how 
big  it  is.  Then  it  uses  Resizelmage  ( )  to  make  a  bee  picture  that’s  squished 
down  to  80  x  40  pixels  and  assigns  that  new  picture  to  its  Image  properly.  Once 
the  PictureBox  is  added  to  the  form,  the  bee  is  displayed. 

private  void  buttonl_Click (object  sender,  EventArgs  e) 


{ 


PictureBox  beePicture  =  new  PictureBox () ; 
beePicture. Location  =  new  Point (10,  10); 
beePicture. Size  =  new  Size (100,  100); 
beePicture. BorderStyle  =  BorderStyle.FixedSingle; 
beePicture. Image  =  Resizelmage ( 

Properties. Resources. Bee_animation_l,  80,  40), 
Controls. Add (beePicture) ; 

You  can  see  the  image  resizing  in 
action— the  squished  bee  image  is  ' 
much  smaller  than  the  PictureBox 
ResizelmageO  squished  it  down 


1  button  1  1 

Just  do  this  temporarily 
Delete  the  button  and 
Code  when  you’re  done 


The  ResizelmageO 
method  creates  a 
Graphics  object  to 
draw  on  an  invisible 
Bitmap  object. 

It  returns  that 
Bitmap  so  it  can  he 
displayed  on  a  lorm 
or  in  PictureBox. 
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Your  image  resources  are  stored  in  bitmap  objects 


W  hen  you  import  graphics  files  into  your  project's  resources, 
what  happens  to  them?  You  already  know  that  you  can  access 
them  using  Properties. Resources.  But  what,  exactly,  is 
your  program  doing  with  them  once  they’re  imported? 

.NET  turns  your  image  into  a  new  Bitmap  >  ibject: 


The  Bitmap  class  has  several  overloaded 
constructors  This  one  loads  a  graphics  -Pile 
+eon>  disk  You  Can  also  pass  ri  integers 
+or  width  and  height— that'll  Create  a  new 
Bitmap  with  no  picture. 


Bitmap  bee 


Bee  animation  l.png 


Then  each  Pitwap  is  drawn  to  the  screen 

Once  your  images  are  in  Bitmap  objects,  your  form 
draws  them  to  the  screen,  with  a  call  like  this: 


using  (Graphics  g  =  CreateGraphics () ) 
g.DrawImage (myBitmap,  30,  30,  150 

DrawImageO  takes  a  Bitmap,  ( 

the  image  to  draw...  * 

...a  starting  )<,  V  Coordinate  - 

The  bigger  they  are... 

Did  you  notice  those  last  two  parameters  to  Draw  Image  ()  ? 

What  if  the  image  in  the  Bitmap  is  1 75  by  1 75?  The 
graphics  library  must  then  resize  the  image  to  lit  150  by  150. 

What  if  the  Bitmap  contains  an  image  that’s  1,500  by  2,025? 

Then  the  scaling  becomes  even  trickier... 


This  image,  which  is 
100*100  pixels 


150)  ; 

and  a  site,  1 50*1 50  pixels. 

Resizing  images  takes  a 
lot  of  processing  power!  If 
you  do  it  once,  it’s  no  big 
deal.  But  if  you  do  it  EVERY 
FRAME,  your  program  will 
slow  down.  We  gave  you 
REALLY  BIG  images  for  the 
bees  and  the  hive.  When 
the  renderer  moves  the 
bees  around  (especially 
in  front  of  the  inside  hive 
picture),  it  has  to  resize 
them  over  and  over  again. 
And  that  was  causing  the 
performance  problems! 


-gets  shrunk  to  this  siz*,  which  is  (-for 

e*ample)  IZOyjzo  p,*e|s.  ^ d  ^  s(ows 

your  simulator  dow J  you  are  here 
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you’re  in  control  v/hen  you  don't  use  controls 


Use  Systew.Prawing  to  TAKE  CONTROL 
of  graphics  yourself 

The  Graphics  object  is  part  of  the  System. Drawing  namespace.  The 
.NET  Framework  comes  with  some  pretty  powerful  graphics  tools 
that  go  a  lot  further  than  the  simple  PictureBox  control  that’s  in  the 
toolbox.  You  can  draw  shapes,  use  fonts,  and  do  all  sorts  of  complex 
graphics...  and  it  all  starts  with  a  Graphics  object.  Any  time  you  want 
to  add  or  modify'  any  object’s  graphics  or  images,  you’ll  create  a 
Graphics  object  that’s  linked  to  the  object  you  want  to  draw  on. 
and  then  use  the  Graphics  object’s  methods  to  draw  on  your  target. 

Start  with  the  object  you  want  to  draw  on 

For  instance,  think  about  a  form.  When  you  call  the  form's 
CreateGraphics  ( )  method,  it  returns  an  instance  of 
Graphics  that’s  set  up  to  draw  on  itself. 


System  .W' 


I 

Calls  on  this  instance  of 
graphics  affect  the  form  that 
created  the  graphics  object 


System. 

V*  9raphiCs  "*^ods  rn  the  System 
r  *9  “^pace  are  sometimes 
-Wdtoas  #>/+,  which  stands  f« 
j  ph,£s  Dev*e  Werfete.  Men  you 
d?LW  9^  with  <5D/+,  you  start 

W'th  a  graphics  obje£t  that's  hooked 

-pt>  a  Bitmap,  &rm,  Control,  or 
another  object  that  you  want  to  draw 
~us,n3  the  graphics  object’s  methods 


The  form  can  call  its  own 
Create^raph.CsO  method, 
or  another  object  can  Call 
it  Either  way,  the  method 
returns  a  reference  to  a 
graphics  object  whose  methods 
will  draw  on  it- 

you  don  t  draw  on  the 
graphics  object  itself, 
you  only  use  it  to  draw 
on  other  object^ 


Use  the  Graphics  object's  methods  to  draw  on  your  object 

Every  Graphics  object  has  methods  that  let  you  draw  on  the  object  that 
created  it.  When  you  call  methods  in  the  Graphics  object  to  draw  lines,  circles, 
rectangles,  text,  and  images,  they  appear  on  the  form. 


Even  though  you’re 
calling  methods  in 
this  graphics  object, 
the  actual  graphics 
appear  on  the  object 
that  Created  it 


O’ 


g  nrawLines  {)_ 


The  DrawLinesO  method, 
for  example,  draws  a  bunch  ^ 

of  lines  on  whatever  object  v  s' 
Created  the  graphics  instance. 


System  VW 
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You'll  need  to  make  sure  you’ve  ^  a 

A  30'Second  tour  of  &PI+  graphics 

...  , 

I  here  are  all  sorts  of  shapes  and  pictures  that  you  can  draw  once  you  ve  project  the  lt>B  adds  that  \ 

created  a  Graphics  object.  All  you  need  to  do  is  call  its  methods,  and  it'll  your  -form  class  automal  >  Iky  *** 

draw  directlv  onto  the  object  that  created  it.  Z'  ' 

A  * 

O  The  first  step  is  always  to  grab  yourself  a  Graphics  object.  Use  a  form's  CreateGraphics  ( ) 

method,  or  have  a  Graphics  object  passed  in.  Remember,  Graphics  implements  the 
IDisposable  ( )  interlace,  so  if  you  create  a  new  one  use  a  using  statement: 

using  (Graphics  g  =  this. CreateGraphics  () )  {  Remember,  -this  draws  on  the  object 

that  Created  this  instance 

If  you  want  to  draw  a  line,  call  DrawLine  ( )  with  starting  point  and  ending  point,  each 
represented  by  X  and  Y  coordinates:  ^ - - - The  start  Coordinate 

g. DrawLine (Pens. Blue,  30,  10,  100, 45); 

""  ’  _ -  and  the  end  Coordinate 

or  you  can  do  it  using  a  couple  of  Points:  " 

g. DrawLine (Pens. Blue,  new  Point(30,  45),  new  Point  (100,  10)); 

Here's  code  that  draws  a  filled  slate  gray  rectangle,  and  then  gives  it  a  sky  blue  border.  It  uses  a  f^here  are  a  whole 
Rectangle  to  define  the  dimensions — in  this  case,  the  upper  left  hand  corner  is  at  (150.  15),  ^°t  °*  to^°*’s  Y0'* 

and  it’s  140  pixels  wide  and  90  pixels  high.  ^  u*e— Jus^ 


g. FillRectangle (Brushes. SlateGray,  new  Rectangle (150,  15,  140,  90)); 
g.DrawRectangle(Pens.SkyBlue,  new  Rectangle (150,  15,  140,  90)); 

You  can  draw  an  ellipse  or  a  circle  using  the  DrawCircle  ( )  or  FillCircle  ( )  methods, 
which  also  use  a  Rectangle  to  specify  how  big  the  shape  should  be.  This  code  draws  two 
ellipses  that  are  slightly  offset  to  give  a  shadow  elTect: 

g.FillEllipse (Brushes. DarkGray,  new  Rectangle (45,  65,  200,  100)); 
g. FillEllipse (Brushes . Silver,  new  Rectangle (40,  60,  200,  100)); 

Use  the  Drawstring  ( )  method  to  draw  text  in  any  font  and  color.  To  do  that,  you’ll  need  to 
create  a  Font  object.  It  implements  IDisposable,  so  use  a  using  statement: 

using  (Font  arial24Bold  =  new  Font ("Arial",  24,  FontStyle.Bold) )  { 
g. Drawstring ("Hi  there!",  arial24Bold,  Brushes. Red,  50,  75); 

1  _ 


can  use— just  type 
"Color",  "Pens"  or 
"Brushes"  -followed 
by  a  dot  and  the 
IntelliSense  window 
will  display  them. 


|f  the  above  statements  are  ^ 
executed  in  order,  this  is  what  will 
end  up  on  the  form  Each  of  the 
statements  above  matches  up  with 
the  numbers  here  The  upper  left- 
hand  Comer  is  Coordinate  (O,  0 )■ 


© 

©*Hi  there! 

© 


There's  no  step  I  on 
•this  picture,  since  that 
was  creating  the  actual 
graphics  object 
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Use  graphics  to  draw  a  picture  on  a  form 


Let's  create  a  new  Windows  application  that  draws  a 
picture  on  a  form  when  you  click  on  it. 


Start  by  adding  a  Click  event  to  the  form 

Go  to  the  Events  page  in  the  Properties  window  (by  clicking  on  the  lightning-bolt  icon), 
scroll  down  to  the  Click  event  and  double-click  on  it. 


Start  the  event  handler  with  a  using  line  to  create 
the  Graphics  object.  When  you  work  with  GD1+,  you 
use  a  lot  of  objects  that  implement  IDisposable.  If 
you  don't  dispose  of  them,  they'll  slowly  suck  up  your 
computer's  resources  until  you  quit  the  program.  So 
you’ll  end  up  using  a  lot  of  using  statements: 


Properties 


Forml  System.Wndows.Forms.Form 

^FTl.ja 


41 


Forml  Click  v 


1 


using  (Graphics  g  =  CreateGraphics () )  { 


f/  Here’s  -the  -first  line  in  your  F'crml_ClickO 
event  handler  method  We'll  jive  you  all 
the  lines  f-or  the  event  handler— yut  them 
together  to  draw  the  picture 

Pay  attention  to  the  order  you  draw  things  on  our  form 

We  want  a  sky  blue  background  for  this  picture,  so  you'll  draw  a  big  blue  rectangle  first — then 
anything  else  you  draw  afterwards  will  be  drawn  on  top  of  it.  You’ll  take  advantage  of  one  of 
die  form’s  properties  called  ClientRectangle.  It’s  a  Rectangle  that  defines  the  boundaries 
of  the  form's  drawing  area.  Rectangles  are  really  useful  you  can  create  a  new  rectangle 
by  specifying  a  Point  for  its  upper  left-hand  corner,  its  width  and  its  height.  Once  you  do  that, 
it'll  automatically  calculate  its  Top,  Left,  Right  and  Bottom  properties  for  you.  And  it's  got 
useful  methods  like  Contains  ( ) ,  which  will  return  true  if  a  given  point  is  inside  it. 

This  will  tome  in  really 


g . FillRectangle (Brushes . SkyBlue,  ClientRectangle) ; 


Draw  the  bee  and  the  flower 

You  already  know  how  die  Drawlmage  ( )  method  works. 


handy  later  on  in 
book'  What  do  you 
think  you’ll  be  doinj 
with  ContainsO? 


75); 


g . Drawlmage (Properties . Resources . Bee_animation_l ,  50,  20,  75, 
g . Drawlmage (Properties .Resources . Flower ,  10,  130,  100,  150); 

_  Pens  are  (or  drawinj  lines,  and  they  have  a 

width  l(  you  want  to  draw  a  -filled  shape  or 
Add  a  pen  that  you  can  draw  with  some  tent,  you’ll  need  a  Brush 

Every  time  you  draw  a  line,  you  use  a  Pen  object  to  determine  its  color  and  thickness.  There’s  a 
built-in  Pens  class  dial  gives  you  plenty  of  pens  (Pens .  Red  is  a  thin  red  pen,  for  example).  But 
you  can  create  your  own  pen  using  the  Pen  class  constructor,  which  lakes  a  Brush  object  and  a 
thickness  (it’s  a  Boat,  so  make  sure  it  ends  with  F).  Brushes  are  how  you  draw  filled  graphics  (like 
tilled  rectangles  and  ellipses),  and  there’s  a  Brushes  class  that  gives  you  brushes  in  various  colors. 


using  (Pen  thickBlackPen  =  new  Pen (Brushes .Black,  3. OF))  { 
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f 


This  goes  inside  the  inner  using 
statement  that  treated  the  Pen. 


Add  an  arrow  that  points  to  the  flower 

There  are  some  Graphics  methods  that  lake  an  array  of  Points,  and  connect  them  using  a 
series  of  lines  or  curves.  We’ll  use  the  DrawLines  ( )  method  to  draw  the  arrow  head,  and  the 
DrawCurve  ( )  method  to  draw  its  shaft.  There  are  other  methods  that  take  point  arrays,  too  (like 
DrawPolygon  ( ) ,  which  draws  a  closed  shape,  and  FillPolygon  ( ) ,  which  fills  it  in.) 


g . DrawLines (thickBlackPen,  new  Point [] 
new  Point (130,  110),  new  Point (120, 
g. DrawCurve (thickBlackPen,  new  Point (] 
new  Point (120,  160),  new  Point (175, 


} 


fWs  where  the  using  block  ervds-we 
don't  need  the  th.ckBlackPen  any  more, 
so  it  II  get  disposed. 


{ 

160),  new  Point (155,  163)}); 
{ 

120),  new  Point (215,  70)  }); 


tWhen  you  pass  an  array  of 
points  to  PrawCurveO,  it 
draws  a  smooth  Curve  that 
Connects  them  all  in  order 


Add  a  font  to  draw  the  text 

Whenever  you  work  with  drawing  text,  die  first  tiling  you  need  to  do  is  create  a  Font  object.  Again, 
use  a  using  statement  because  Font  implements  IDisposable.  Creating  a  font  is  straightforward. 
1’here  are  several  overloaded  constructors  the  simplest  one  takes  a  font  name,  font  size,  and 
FontStyle  enum. 


using  (Font  font  =  new  Font ("Arial",  16,  FontStyle. Italic) )  { 


Add  some  text  that  says  "Nectar  here” 

Now  that  you’ve  got  a  font,  you  can  figure  out  where  to  put  the  string  by  measuring  how  big  it  will  be 
when  it's  drawn.  The  Measurestring  ( )  method  returns  a  SizeF  that  defines  its  size.  (SizeF  is 
just  the  float  version  of  Size  and  both  of  them  just  define  a  width  and  height.)  Since  we  know 
where  the  arrow  ends,  w'e'll  use  the  string  measurements  to  position  its  center  just  above  the  arrow. 


SizeF  size  =  g. Measurestring ("Nectar  here",  font); 
g. DrawString ("Nectar  here",  font,  Brushes. Red,  new  Point ( 
215  -  (int) size. Width  /  2,  70  -  (int) size . Height) ) ; 

} 

Make  sure  you  close  out  both  using  blocks 

You  can  create  a  Rectangle  ky  giving  it  a  point 
and  a  Size  (or  widtk  and  keigkt).  Once  you’ve 
got  it,  you  can  find  its  koundarics  and  ckeck  its 
ContainsO  metkod  to  see  if  it  contains  a  Point. 


what’s  it  look  like? 


1 .  Most  of  your  work  with  Graphics  will  involve  thinking 
about  your  forms  as  a  grid  of  X,  Y  coordinates.  Here's  the 
code  to  build  the  grid  shown  below;  your  job  is  to  fill  in 
the  missing  parts. 


using  (Graphics  g  =  this.CreateGraphics  () ) 
using  (Font  f  =  new  Font ("Arial",  6,  FontStyle. Regular) )  ( 
for  (int  x  =  0;  x  <  this. Width;  x  +=  20)  ( 


)  . 

for  (int  y  =  0;  y  <  this. Height;  y  +=  20)  { 


) 


2.  Can  you  figure  out  what  happens  when  you  run  the  code 
below?  Draw  the  output  onto  the  form,  using  the  grid  you 
just  rendered  for  locating  specific  points. 

using  (Pen  pen  = 

new  Pen (Brushes .Black,  3. OF))  ( 
g.DrawCurve (pen,  new  Point []  { 
new  Point (80,  60), 
new  Point (200, 40) , 
new  Point (180,  60), 
new  Point  (300, 40) , 

>>  ; 

g.DrawCurve (pen,  new  Point []  ( 

new  Point ( 300, 180) ,  new  Point (180, 
new  Point (200, 180) ,  new  Point (80, 
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>); 

g.DrawLine (pen,  300,  40,  300,  180); 
g.DrawLine (pen,  80,  60,  80,  200); 
g.DrawEllipse (pen,  40,  40,  20,  20); 
g.DrawRectangle (pen,  40,  60,  20,  300); 
g.DrawLine (pen,  60,  60,  80,  60); 
g.DrawLine (pen,  60,  200,  80,  200); 
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3.  Here's  some  more  graphics  code,  dealing  with  irregular 
shapes.  Figure  out  what's  drawn  using  the  grid  we've  given 
you  below. 


F  WyW),  IWW*  ,„d  4  otw 

rriftv **,i  u^neU. **  *.  ^ 

tw  <W«  th,  write  ,  «te  of  to™«  Jd  |«. 


g.FillPolygon (Brushes. Black,  new  Point []  ( 

new  Point (60, 40) ,  new  Point (140, 80) ,  new  Point (200, 40) , 
new  Point (300, 80) ,  new  Point (380, 60) ,  new  Point (340, 140) , 
new  Point (320, 180) ,  new  Point (380, 240) ,  new  Point (320, 300) , 
new  Point (340, 340) ,  new  Point (240, 320) ,  new  Point (180, 340) , 
new  Point (20, 320) ,  new  Point (60,  280),  new  Point (100,  240), 
new  Point  (40,  220),  new  Point (80, 160) , 


))  l 


using  (Font  big  =  new  Font("Times  New  Roman",  24,  FontStyle. Italic) )  ( 
g. DrawString ("Pow! ",  big,  Brushes. White,  new  Point(80,  80)); 
g. Drawstring ("Pow! ",  big,  Brushes .White,  new  Point (120,  120)); 
g. DrawString ("Pow! ",  big,  Brushes. White,  new  Point(160,  160)); 
g. DrawString ("Pow! ",  big,  Brushes. White,  new  Point(200,  200)); 
g. DrawString ("Pow! ",  big.  Brushes. White,  new  Point (240,  240)); 

I 


•  Forml  ] 
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looks  good,  except... 


Sharpen  your  pencil 
^  v  Solution 


Your  job  was  to  fill  in  the  missing  code  to  draw  a  grid,  and  plot 
two  chunks  of  code  on  the  grids. 


we  draw  the 
vertical  Ij^j 
the  numbers  along  - 
the  y  axis.  There's 
*  vertical  line 
every  20  pixels 
a,°"9  the  X  axis. 


using  (Graphics  g  =  this.CreateGraphics () ) 

using  (Font  f  =  new  Font  ("Arial",  6,  FontStyle. Regular ) )  (  We  used  using 


for  (int  x  =  0;  x  <  this. Width;  x  +=  20)  ( 

^  gDrawLme(PensBlack,  x,  O,  x,  this.ReMght); 

^DrawStrinJ^xToStringt),  f,  Brushes. Black,  x,  O)', 

} 

for  (int  y  =  0;  y  <  this. Height;  y  +=  20)  ( 


jN-  statements  to 
make  sure  the 
graphics  and 
Font  object  get 
disposed  after  the 
form's  drawn. 


*  Forml 


g  Vr awLme(Pe ns  B  lack ,  0,  y,  thisWidth,  y); 

.  .Y?.t.  Next  we  draw  the  horizontal 

^  lines  and  X  a*is  numbers  To 
\.  draw  a  horizontal  line,  you 
choose  a  y  value  and  draw  a 
line  from  (0,  y)  on  the  left 
of  the  form  to  (O,  this  Width) 
on  the  right— hand  side  of  the 
form. 
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The  renderer  drew  the  bees  so 


Graphics  caw  fix  our  transparency  problem... 


You’ve  probably  figured  out  by  now  that  Drawlmage  ( ) 
is  the  key  to  fixing  the  problem  in  the  Tenderer  where  the 
images  were  drawing  those  boxes  around  the  bees  and 
(lowers  that  caused  the  overlap  issues.  So  let’s  tackle  them! 
Go  back  to  your  Windows  application  with  the  picture. 


y^Do  this. 


Add  a  DrawBee  ( )  method  that  draws  a  bee  on  any  Graphics  object.  It  uses  the 
overloaded  Drawlmage  ( )  constructor  that  lakes  a  Rectangle  to  determine  where 
to  draw  the  image,  and  howr  big  to  draw  it. 
public  void  DrawBee (Graphics  g.  Rectangle  rect)  { 

g. Drawlmage (Properties .Resources .Bee_animation_l ,  rect) 

) 


Here’s  the  new  Click  event  handler  for  the  form.  Take  a  close-  look  at 
how'  it  works  it  draws  the  hive  so  that  its  upper  left-hand  corner  is  way  olT 
the  form,  at  location  (-Width,  -Height) ,  and  it  draws  it  at  twice  the 
w  idth  and  height  of  the  form  so  you  can  resize  the  form  and  it’ll  still  draw 
okay.  Then  it  draws  four  bees  using  the  DrawBee  ( )  method. 

private  void  Forml_Click (object  sender,  EventArgs  e)  ( 
using  (Graphics  g  =  CreateGraphics  ( ) )  { 

g. Drawlmage (Properties .Resources . Hive _ inside_, 

-Width,  -Height,  Width  *  2,  Height  *  2) ; 
Size  size  =  new  Size (Width  /  5,  Height  /  5) 
DrawBee (g,  new  Rectangle ( 
new  Point (Width  / 

DrawBee (g,  new  Rectangle ( 
new  Point (Width  / 

DrawBee (g,  new  Rectangle( 

new  Point (Width  /  2  -  80,  Height  / 
DrawBee (g,  new  Rectangle ( 

new  Point (Width  /  2  -  90,  Height  / 


/VjuCh  better— click  on  the  form 
and  the  bees  overlap  just  fine. 


First  we'll  draw  the 
hive  bdekround,  with  its 
Corner  far  off  the  page 
so  we  only  see  a  small 
piece  of  it-  Then  we  II 
draw  four  bees  so  that 
they  overlap— if  they 

don't,  make  your  form 
bigger  and  then  click  oi 
it  again  so  they  do 


-  50,  Height  / 

-  20,  Height  / 


2  - 


2  - 


2  - 


2  - 


40) ,  size) ) ; 
60) ,  size) ) ; 
30) ,  size) ) ; 
80) ,  size) ) ; 


1 


> 


...but  there's  a  catch 


But  look  what  happens  i-f  you 
drag  it  off  the  side  of  the 
screen  and  back^  Oh  no1 


© 


Run  your  program  and  click  on  the  form,  and  watch  it  draw  the  bees!  But 
something’s  wrong  When  you  drag  the  form  off  the  side  of  the  screen  and 
back  again,  the  picture  disappears!  Now  go  back  and  check  the  ''Nectar 
here”  program  you  wrote  a  lew  pages  ago  it’s  got  the  same  problem! 

What  do  you  think  happened? 


you  are  here  > 
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Use  the  Paint  event  to  wake  your  graphics  stick 

What  good  are  graphics  if  they  disappear  from  your  form  as  soon  as  part  of  your 
form  gets  covered  up?  They’re  no  good  at  all.  Luckily,  there’s  an  easy  way  to  make 
sure  your  graphics  stay  on  your  form:  just  write  a  Paint  event  handler.  Your 
form  fires  a  Paint  event  every  time  it  needs  to  redraw  itself — like  when  it's  dragged 
off  the  screen.  One  of  the  properties  of  its  PaintEventArgs  parameter  is  a 
Graphics  object  called  Graphics,  and  anything  that  you  draw  with  it  will  “stick”. 


Forms  and  controls 
have  a  Paint  event 
that  gives  y  ou  a 
Graphics  object. 
Anything  you  draw 
on  it  is  repainted 
automatically. 


Add  q  Paint  event  handler 

Double-click  on  “Paint”  in  the  Events  page  in  the  Properties  window  to  add  a  Paint  event  handler. 
The  Paint  event  is  fired  any  time  the  image  on  your  form  gets  “dirty”.  So  drawing  your  graphics 
inside  of  il  will  make  your  image  will  stick  around. 


Properties 


Double-click  on  Paint  to  add  a  Paint  event  handler.  Its 
PaintEventAry  has  a  property  called  graphics— and 
anything  you  draw  with  it  will  stick  to  your  form - 


I  Fomtl  System. 'Mrdows.Forms.Forn 

I  vTi  urn  -i 


] 


Q  Use  the  Graphics  object  from  the  Paint  event's  EventArgs 

Instead  of  starting  with  a  using  statement,  make  your  event  handler  start  like  this: 

private  void  UserControll_Paint (object  sender,  PaintEventArgs  e)  { 

Graphics  g  =  e. Graphics; 

You  don’t  have  to  use  a  using  statement — since  you  didn't  create  it,  you  don’t  have  to  dispose  it. 

Copy  the  code  that  draws  the  overlapping  bees  and  hive 

Add  the  new  DrawBeesQ  method  from  the  previous  page  into  your  new  user  control.  Then  copy 
the  code  from  the  Click  event  into  your  new  Paint  event  except  for  the  first  line  with  the 
using  statement,  since  you  already  have  a  Graphics  object  called  g.  (Since  you  don’t  have 
the  using  statement  any  more,  make  sure  you  take  out  its  closing  curly  bracket.)  Now  run  your 
program.  The  graphics  stick!  po  the  same  with  your  "Nectar  Were 

drawing  to  make  it  stick,  too- 

Poems  and  Controls  redraw  themselves  all  the  time 

It  may  not  look  like  it,  but  your  forms  have  to  redraw  themselves  oil  i  *  , 

:  & , rt  mr*;  ^  3  ^ 

or  uncover  the  part  o+  the  form  that  was  Covered  uP  is  now  invalid  whiek  ,  i  , 

TV  U.  fc.  M  .  ft*  e<e„t  "*'a* 

*  .drty.  ^  it,7Xri.o7ur 
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ExeRctSe 


See  if  you  can  combine  your  knowledge  of  forms  and  user  controls— and  get  a  little  more 
practice  using  Bitmap  objects  and  and  the  Drawlmage  ( )  method— by  building  a  user 
control  that  uses  TrackBars  to  zoom  an  image  in  and  out. 


Add  two  TrackBar  controls  to  a  new  user  control 

Create  a  new  Windows  Application  project.  Add  a  User  Control  call  it  Zoomer  and  set  its 
Size  property  to  (300,  300).  Drag  two  TrackBar  controls  out  of  the  toolbox  and  onto  it.  Drag 
trackBarl  to  the  bottom  of  the  control.  Then  drag  trackBar2  to  the  right-hand  side  of  the 
control  and  set  its  Orientation  property  to  Horizontal.  Both  should  have  the  Minimum 
property  set  to  1 .  Maximum  set  to  1 75,  Value  set  to  1 75,  and  TickStyle  set  to  None.  Set 
each  TrackBar ’s  background  color  to  white.  Finally,  double-click  on  each  trackbar  to  add  a 
Scroll  event  handler.  Make  both  event  handlers  call  the  control's  Invalidate  ()  method. 


You  user  control  has  a  Paint 
event,  and  it  works  just  like  the 
one  you  just  used  in  the  form. 
Just  use  its  PaintEventArgs 
parameter  e.  It  has  a  property 
called  Graphics,  and  anything 
that  you  draw  with  that  Graphics 
object  will  be  painted  onto  any 
instance  of  the  user  control  you 
drag  out  of  the  Toolbox. 


fy  ve  •the  tvjo  trackbars 
white  backgrounds 
because  you’ll  be  drawing 
a  white  rectangle  behind 
everything,  and  you  want 
them  to  blend  in 


Load  a  picture  into  a  Bitmap  object  and  draw  it  on  the  control 

Add  a  private  Bitmap  field  called  photo  to  your  Zoomer  user  control.  When  you  create  the  instance 
of  Bitmap,  use  its  constructor  to  load  your  favorite  image  file — we  used  a  picture  of  a  llully  dog. 
Then  add  a  Paint  event  to  the  control.  The  event  handler  should  create  a  graphics  object  to  draw 
on  the  control,  draw  a  white  filled  rectangle  over  the  entire  control,  and  then  use  Drawlmage  ( )  to 
draw  the  contents  of  your  photo  field  onto  your  control  so  its  upper  left-hand  corner  is  at  (10,  10),  its 
width  is  trackBar  1  .Value,  and  its  height  is  trackBar2  .Value.  Then  drag  your  control  onto 
the  form — make  sure  to  resize  the  form  so  the  trackbars  are  at  the  edges. 


When  y<~  ",ove  ^eL 

trackbars,  -the  future 

Will  shrink  and  yoJ 
\ 


El 


Whenever  the  user  scrolls  one  of  the 
TrackBars,  they  call  the  user  control’s 
Invalidate!)  method.  That  will  cause  the  user 
control  to  fire  its  Paint  event  and  resize  the 
photo.  Remember,  since  you  didn’t  create 
the  Graphics  object — it  was  passed  to  you 
in  PaintEventArgs — you  don’t  need  to 
dispose  it.  So  you  don’t  have  to  use  a  using 
statement  with  it.  Just  draw  the  image  inside 
the  Paint  event  handler. 
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how  the  paint  event  works 


EbteftaSe 

Solution 


Get  a  little  more  practice  using  Bitmap  objects 
and  and  the  Draw  image  ( )  method  by  building 
a  form  that  uses  them  to  load  a  picture  from  a  file 
and  zoom  it  in  and  out. 


overloaded  eor,si-y  *  9°^  °ther 

<'*■  y~ 


public  partial  class  Zoomer  :  UserControl  { 


Bitmap  photo  =  new  Bitmap(@"c: \Graphics\fluffy_dog. jpg") ; 

public  Zoomer ()  { 

InitializeComponent () ; 

} 

private  void  Zoomer_Paint (object  sender,  PaintEventArgs  e)  { 
Graphics  g  =  e. Graphics; 

g. FillRectangle (Brushes .White,  0,  0,  Width,  Height); 
g.DrawImage (photo,  10,  10,  trackBarl .Value,  trackBar2 .Value) ; 

>  First  we  draw  a  big  white  rectangle  so  it  ■f'lls  up  the  whole  Control,  then  we 

}  \  draw  the  ?hoto  on  top  of  it-  The  last  two  peters  determine  the  s,  W 

^  the  image  being  drawn-trackBarl  sets  the  width,  trackBarl  sets  the  heig  t 

private  void  trackBarl_Scroll (object  sender,  EventArgs  e)  { 
Invalidate  ()  ; 


private  void  trackBar2_Scroll (object  sender,  EventArgs  e)  { 

Invalidate  ( )  ;  F very  time  the  user  slides  one  of  the  trackbar  Controls,  it  fires 
}  off  a  Scroll  event-  By  making  the  event  handlers  call  the  Control's 

Invalidate  ()  method,  we  cause  the  form  to  repaint  itself...  and 
when  it  does,  it  draws  a  new  Copy  of  the  image  with  a  different  size- 


El 


Bach  drag  here  is  causing  another  image 
^resize  from  DrawImageO. 


g.DrawImage (myBitmap,  30,  30,  150,  150); 
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A  closer  look  at  how  forms  and  controls 
repaint  themselves 


Behind 
the  Scenes 


Remember  earlier,  we  said  that  when  you  start  working  with  Graphics  objects,  you're  really  taking 
control  of  graphics.  It's  like  you  tell  .NET,  “Hey,  I  know  what  I'm  doing,  I  can  handle  the  extra 
responsibility."  In  the  rase  of  drawing  and  redrawing,  you  may  not  want  to  redraw'  when  a  form 
is  minimized  and  maximized...  or  you  may  want  to  redraw  more  often.  Once  you  know  what’s 
going  on  behind  the  scenes  with  your  form  or  control,  you  can  take  control  of  redrawing  yourself: 


Every  form  has  a  Paint  event  that  draws  the  graphics  on  the  form 

Go  to  the  event  list  for  any  form  and  find  the  event  called  Paint.  Whenever  the  form  has  to  repaint  itself, 
this  event  is  fired.  Every  form  and  control  uses  a  Paint  event  internally  to  decide  when  to  redraw  itself.  But 
what  fires  that  event?  It's  called  by  a  method  called  OnPaint  that  the  form  or  user  control  inherits  from  the 
Control  class.  (That  method  follows  the  pattern  you  saw  in  Chapter  1 1 ,  where  methods  dial  fire  an  event  are 
named  "On"  followed  by  die  event  name.)  Go  to  any  form  and  override  OnPaint:  Do  this  jusf  like  you  did 

Override  OnPain-t  protected  override  void  OnPaint  (PaintEventArgs  e)  {  earlier  with  DisposeO 

on  any  -form  and - ^ Console. WriteLine( "OnPaint  {0}  {1)",  DateTime . Now ,  e.ClipRectangle)  ; 

add  'this  line. 

1 


base. OnPaint (e) ; 


Drag  your  form  around — drag  it  hallway  off  the  screen,  minimize  it,  hide  it  behind  other  w  indows.  Watch 
closely  at  the  output  that  it  writes.  You’ll  see  that  your  OnPaint  method  fires  off  a  Paint  event  any  time  part 
of  it  is  “dirty” — or  invalid — and  needs  to  be  redrawn.  And  if  you  look  closely  at  the  Clip  Rectangle,  you'll 
see  that  it's  a  rectangle  that  describes  die  part  of  the  form  that  needs  to  be  repainted.  That  gets  passed  to  the 
Paint  event’s  PaintEventArgs  so  it  can  improve  performance  by  only  redrawing  the  portion  that's  invalid. 

Lvalida-teO  essentially 

Invalidate()  controls  when  to  redraw,  and  WHAT  to  redraw  ^  s  rQ^t  ^  the 

.NET  fires  the  Paint  event  when  something  on  a  form  is  interfered  with,  covered  up,  ^  ^  “invalid,” 

or  moved  offscreen,  and  then  shown  again.  It  calls  Invalidate  ( ) ,  and  passes  the  redraw/  that  yari  to 

method  a  Rectangle.  The  Rectangle  tells  the  Invalidate  ( )  method  what  ^  ^  the 

part  of  the  form  needs  to  be  redrawn...  what  part  of  the  form  is  “dirty.”  Then  .NET  ^  showing 

calls  OnPaint  to  tell  your  form  to  fire  a  Paint  event  and  repaint  the  dim  area.  r  ^  a 

I 

So  when  you  tall  it 
yourself,  you’re  telling 
NET  that  your  whole  torn, 
or  Control  is  invalid,  and 
the  whole  thin<J  needs  to 
be  redrawn  You  tan  yass 
it  your  own  tliy  rettan^le 
if  you  want— that  II 

yassed  alon^  to  the  Paint 
event’s  PaintEventArgs- 


The  Update()  method  gives  your  Invalidate  request  top  priority 

You  may  not  realize  it,  blit  your  form  is  getting  messages  all  the  time.  The  same 
system  that  tells  it  that  it’s  been  covered  up  and  calls  OnPaint  has  all  sorts  of  other 
messages  it  needs  to  send.  See  for  yourself:  type  override  and  scroll  through  all  the 
methods  that  start  with  “On” — every  one  of  them  is  a  message  your  form  responds  to. 
The  Update  ( )  method  moves  the  Invalidate  message  to  the  lop  of  the  message  list. 

The  form's  Refresh()  method  is  Invalidate()  plus  Update() 

Forms  and  controls  give  you  a  shortcut.  They  have  a  RefreshO  method  that  first  calls 
InvalidateO  to  invalidate  die  whole  client  area,  tuid  then  calls  UpdateO  to  make  sure 
that  message  moves  to  the  top  of  the  list. 
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what’s  with  the  flickering? 


It  still  seems  like  just  resizing 
the  graphics  in  a  program  like  Paint  or 
Photoshop  would  be  better.  Why  can't  I 
do  that? 

You  can,  if  you’re  in  control  of  the 
images  you  work  with  in  your  applications, 
and  if  they'll  always  stay  the  same  size  But 
that's  not  often  the  case.  Lots  of  times,  you'll 
get  images  from  another  source,  whether  it’s 
online  or  a  co-worker  in  the  design  group. 

Or,  you  may  be  pulling  an  image  from  a 
read-only  source,  and  you  have  to  size  it 
programmatically. 

o 

But  if  I  can  resize  it  outside  of  .NET, 
that's  better,  right? 

If  you're  sure  you'll  never  need  a  larger 
size,  it  could  be.  But  if  your  program  might 
need  to  display  the  image  in  multiple  sizes 
during  the  program,  you'll  have  to  resize  at 
some  point  anyway.  Plus,  if  your  image  ever 
needs  to  be  displayed  larger  than  the  resize, 
you'll  end  up  in  real  trouble.  It's  much  easier 
to  size  down  than  it  is  to  size  up. 

More  often  than  not,  it’s  better  to  be  able  to 
resize  an  image  programmatically,  than  to  be 
limited  by  an  external  program  or  constraints 
like  read-only  files. 

U:  I  get  that  CreateGraphics()  gets  the 
Graphics  object  for  drawing  on  a  form, 
but  what  was  that  From!mage()  call  in  the 
Resizelmagef)  method  about? 

Fromlmage  ( )  retrieves  the 
Graphics  object  for  a  Bitmap  object. 
And  just  as  CreateGraphics  ( ) 
called  on  a  form  returns  the  Graphics 
object  for  drawing  on  that  form, 
Fromlmage  ()  retrieves  a  Graphics 
object  for  drawing  on  the  Bitmap  the 
method  was  called  on. 


tWeiOre  no 

Dumb  Questions 

O 

So  a  Graphics  object  isn’t  just  for 
drawing  on  a  form? 

Actually,  a  Graphics  object  is  for 
drawing  on,  well,  anything  that  gives  you 
a  Graphics  object.  The  Bitmap  gives  you  a 
Graphics  object  that  you  can  use  to  draw 
onto  an  invisible  image  that  you  can  use 
later.  And  you'll  find  Graphics  objects  on  a 
lot  more  than  forms.  Drag  a  button  onto  a 
form,  then  go  into  your  code  and  type  its 
name  followed  by  a  penod.  Check  out  the 
IntelliSense  window  that  popped  up— it  s 
got  CreateGraphics()  method  that  returns  a 
Graphics  object.  Anything  you  draw  on  it  will 
show  up  on  the  button!  Same  goes  for  Label, 
PictureBox,  StatusStrip ...  almost  every 
toolbox  control  has  a  Graphics  object, 

cv 

V^.  Wait,  I  thought  using  was  just 
something  I  used  with  streams.  Why  am  I 
using  using  with  graphics? 

^\lThe  using  keyword  comes  in 
handy  with  streams,  but  it's  something  that 
you  use  with  any  class  that  implements 
the  IDisposable  interface.  When  a 
class  implements  IDisposable,  any 
time  you  instantiate  it  you  should  call  its 
Dispose  ()  method.  With  streams,  the 
Dispose  ()  method  makes  sure  that  any 
file  that  was  opened  gets  closed. 

Graphics,  Pen,  and  Brush  objects 
are  also  disposable  When  you  create  any 
of  them,  they  take  up  some  small  amount 
of  memory  and  other  resources,  and  they 
don't  always  give  them  back  immediately. 

If  you're  just  drawing  something  once,  you 
won't  notice  a  difference.  But  most  of  the 
time,  your  graphics  code  will  be  called 
over  and  over  and  over  again— like  in  a 
Paint  event  handler,  which  could  get 
called  many  times  a  second  for  a  particularly 
busy  form.  That's  why  you  should  always 


Dispose  ( )  of  your  graphics-related 
objects.  And  the  easiest  way  to  make  sure 
that  you  do  is  to  use  a  using  line,  and  let 
.NET  worry  about  disposal.  Any  object  you 
create  with  using  will  automatically  have 
its  Dispose  ( )  method  called  at  the  end 
of  the  block  following  the  using  statement, 
That  will  guarantee  that  your  program  won  t 
slowly  take  up  more  and  more  memory  if  it 
runs  for  a  long  time. 

Qj  If  I’m  creating  a  new  control,  should 
I  use  a  UserControl  or  should  I  create  a 
class  that  inherits  from  one  of  the  toolbox 
controls? 

That  depends  on  what  you  want  your 
new  control  to  do.  If  you're  building  a  control 
that’s  really  similar  to  one  that’s  already 
in  the  toolbox,  then  you’ll  probably  find  it 
easiest  to  inherit  from  that  control.  But  most 
of  the  time,  when  programmers  create  new 
controls  in  C#,  they  use  user  controls.  One 
useful  advantage  of  a  user  control  is  that  you 
can  drag  toolbox  controls  onto  it.  It  works 
a  lot  like  a  GroupBox  or  other  container 
control— you  can  drag  a  button  or  checkbox 
onto  your  user  control,  and  work  with  them 
just  like  you'd  work  with  controls  on  a  form 
The  IDE’s  form  designer  becomes  a  powerful 
tool  to  help  you  design  user  controls  You'll 
see  more  about  that  in  just  a  minute. 

A  user  control  can 
kost  otker  controls. 
Tke  IDE’s  form 
designer  lets  you 
drag  controls  out  of 
tke  toolkox  and  onto 
your  new  user  control. 
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I  noticed  a  whole  lot  of  flickering  in  my  Zoomer 
control.  With  all  this  talk  of  taking  control  of 
graphics.  I'll  bet  there's  something  we  can  do 
about  that!  But  why  does  it  happen? 


Even  without  resizing,  it  takes  time 
to  draw  an  image  to  a  form. 

Suppose  you've  got  every  image  in  the  simulator 
resized.  It  still  t<»kes  time  to  draw  all  those  bees  and 
flowers  and  the  hive.  And  right  now,  we’re  drawing 
right  to  the  Graphics  object  on  the  form.  So  if 
your  eye  catches  the  tail  end  of  a  render,  you’re 
going  to  perceive  it  as  a  little  flicker. 

The  problem  is  that  a  lot  of  drawing  is  happening, 
so  there's  a  good  chance  that  some  flickering  will 
occur,  even  with  our  resizing.  And  that’s  why  you 
run  into  problems  with  most  amateur  computer 
games...  the  human  eye  catches  the  end  of  a 
rendering  cycle,  and  perceives  it  as  a  little  bit  of 
flickering  on  the  screen. 


O 

0 


*  * 


PCWEt? 

How  could  you  get  rid  of  this  flicker?  If  drawing  lots 
of  images  to  the  form  causes  flickering,  and  you 
have  to  draw  lots  of  images,  how  do  you  think  you 
might  be  able  to  avoid  all  the  flickering? 
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make  your  animation  smoother 


double  buffering  wakes  animation  look  a  lot  smoother 


(Jo  bark  lo  your  image  zoomer  and  fiddle  with  the  trackbars.  Notice  how  there's  a 
whole  lot  of  flickering  when  you  move  the  bars?  That’s  Ijecause  the  Paint  event 
handler  first  has  to  draw  the  white  rectangle  and  then  draw  the  image  every  time 
the  trackbar  moves  a  tiny  little  bit.  W  hen  your  eyes  see  alternating  white  rectangles 
and  images  many  times  a  second,  they  interpret  that  as  flicker.  It's  irritating...  and  it's 
avoidable  using  a  technique  called  double  buffering. That  means  drawing  each 
frame  or  cell  of  animation  to  an  invisible  bitmap  (a  “buffer”),  and  only  displaying  the 
new  frame  once  it’s  been  drawn  entirely.  Here’s  how  it  would  work  with  a  Bitmap: 


Here’s  a  typical  program  that  draws  some  graphics  on  a  form  using  its  Graphics  object. 


was  drawn  m  petei, 

To  do  double  buffering,  we  can  add  a  Bitmap  object  to  the  program  to  act  as  a  buffer. 
Every  time  our  form  or  control  needs  to  be  repainted,  instead  of  drawing  the  graphics 
directly  on  the  form,  we  draw  on  the  buffer  instead. 


Q* 

^endel^ 


using  (graphics  g  = 

Graphics . Fromlmage (bitmap) ) 
DrawOne Frame (g) ;  ) 


By  drawing  each  -frame  to 
invisible  bitmap,  the  users 
won't  see  the  flicker  any  more 
They'll  only  see  the  finished 
frame  when  we  Copy  it  from 
the  bitmap  back  to  the  -form 


3rap)ri'G 


Now  that  the  frame  is  completely  drawn  out  to  the  invisible  Bitmap  object,  we  can 
use  DrawImageUnscaled  ( )  lo  copy  the  object  back  to  the  form’s  Graphics.  It 
all  gets  copied  at  once,  and  that  eliminates  the  flicker. 


using  ^£aphlrCrSaPnics01  l 
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Pouble  buffering  is  built  into  forms  and  controls 

You  ran  do  double  buffering  yourself  using  a  Bitmap,  but  C#  and  .NET  make  it 
even  easier  with  built-in  support  for  double  buffering.  All  you  need  to  do  is  set 
its  DoubleBuflered  property  to  true.  Try  it  out  on  your  Zootner  user  control- 
go  to  its  Properties  window,  set  DoubleBuflered  to  true,  and  your  control  will  stop 
flickering!  Now  go  back  to  your  BeeControl  and  do  the  same.  That  won't  fix  all 
ol"  the  graphics  problems—  we'll  do  that  in  a  minute  lint  it  will  make  a  difference. 

Now  you’re  ready  to  fix  the  graphics  problems  in  the  simulator! 

Overhaul  the  Peehive  Simulator 

In  the  next  exercise,  you'll  take  your  Beehive  Simulator  and  completely  overhaul 
it.  You'll  probably  want  to  create  a  whole  new  project  and  use  "‘Add  »  Existing 
Item...”  to  add  the  current  files  to  it  so  you  have  a  backup  of  your  current 
simulator.  (Don’t  forget  to  change  their  namespace  to  match  your  new  project.) 

Here’s  what  you're  going  to  do: 


When  you  use 
the  Paint  event 
lor  all  your 
graphics,  you 
can  turn  on 
double  buffered 
painting  simply 
hy  changing  one 
property. 


You’ll  start  by  removing  the  BeeControl  user  control 

There  won't  be  any  controls  on  die  hive  and  field  at  all.  No  BeeControls,  no  PietureBoxes, 
nothing.  The  bees,  (lowers,  and  hive  pictures  will  all  be  drawn  using  GDI+  graphics.  So  right- 
click  on  BeeControl.es  (and  OldBeeControl.es)  in  the  Solution  Explorer  and  click  Delete — they’ll 
be  removed  from  the  project  and  permanently  deleted. 


You’ll  need  a  timer  to  handle  the  bee  wing  flapping 

Ilie  bees  flap  their  wings  much  more  slowly  than  the  simulator’s  frame  rate,  so  you'll  need  a 
second,  slower  timer.  This  shouldn’t  be  too  surprising,  since  the  BeeControl  had  its  own  timer  to 
do  the  same  thing. 


The  big  step:  overhaul  the  renderer 

You’ll  need  to  throw  out  the  current  renderer  entirely,  because  it  does  everything  with 
controls.  You  won’t  need  those  lookup  dictionaries,  because  there  won’t  be  any  PietureBoxes  or 
BeeControls  to  look  up.  Instead,  it'll  have  two  important  methods:  DrawHive(g)  will  draw  a  Hive 
form  on  a  graphics  object,  and  DrawField(g)  w  ill  draw'  a  Field  form. 


Last  of  all,  you’ll  hook  up  the  new  renderer 

The  Hive  and  Field  forms  will  need  Paint  event  handlers.  Each  of  them  will  call  the  Renderer 
object's  Draw  Field(g)  or  Draw  Hive(g)  methods.  The  two  timers — one  lor  telling  the  simulator  to 
draw  the  next  frame,  and  the  other  to  flap  the  bees'  w  ings — will  call  the  two  forms’  InvalidateQ 
methods  to  repaint  themselves.  When  they  do,  their  Paint  event  handlers  w  ill  render  the  frame. 

Lets  get  started!  - ► 
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rebuild  the  renderer 


It’s  time  to  get  rid  of  the  graphics  glitches  in  the  beehive  simulator.  Use  graphics  and  double 
buffering  to  make  the  simulator  look  polished 


Change  the  main  form’s  RunFrame()  method 

You'll  need  to  remove  the  t  all  to  Renderer .  Render  ( )  and  add  two  Invalidate  ( ) 
statements. 


public  void  RunFrame (object  sender,  EventArgs  e)  { 

framesRun++;  y^jl  -to  remove  the  tall  to  renderer  RenderO, 

world. Go  (random) ;  ilnte  th*t  method  will  5®  away 

end  =  DateTime.Now; 

start; 


TimeSpan  f rameDuration  =  end  - 
start  =  end; 

UpdateStats (f rameDuration) , 
hiveForm. Invalidate () ; 
f ieldForm. Invalidate ( ) 


or  ms 


A*  long  as  you  keep  the  world  up  to  date  and  both  f< 
have  a  reference  to  the  renderer  object,  all  you  need 
to  do  to  animate  them  is  call  the,r  Invalidate  () 
methods  The.r  Paint  event  handlers  will  take  tare  of 


Add  a  second  timer  to  the  main  form  to  make  the  bees’  wings  flap 

Drag  a  new  limer  onto  the  main  form,  set  its  Interval  to  150ms  and  Enabled  to  true. 
Then  double-click  on  it  and  add  this  event  handler: 


private  void  timer2_Tick (object  sender,  EventArgs  e)  ( 
renderer .AnimateBees  () ; 

1 

Then  add  this  AnimateBees  ()  method  to  the  renderer  to  make  the  bees'  wings  flap: 


private  int  Cell  =  0; 
private  int  Frame  =  0; 
private  void  AnimateBees ( )  ( 
Frame++; 
if  (Frame  >=  6) 

Frame  =0; 


switch  (Frame)  ( 

case 

0: 

Cell  =  0; 

break; 

case 

1: 

Cell  =  1; 

break; 

case 

2: 

Cell  =  2; 

break; 

case 

3: 

Cell  =  3; 

break; 

case 

4: 

Cell  =  2; 

break; 

case 

5: 

Cell  =  1; 

break; 

default 

:  Cell  =  0 

;  break 

1 

hiveForm. Invalidate ( ) ; 
f ieldForm. Invalidate ( )  ; 


The  whole  idea  here  is  to  set  a  field  called 
Cell  that  you  can  use  when  you’re  drawing 
■the  bees  in  the  renderer  Alake  sure  you’re 
always  drawing  Bee  AmmationL-ar  get  Cell  J  in 
the  hive  form  and  BeeAnimationSmallCCclU  in 
the  f  ield  form.  The  timer  will  Constantly  call 
the  AnimateBeesO  method,  which  will  cause 
the  Cell  field  to  keep  changing,  which  will 
cause  your  bees  to  flap  their  wings 


610  Chapter  13 


controls  and  graphics 


Set  up  the  hive  and  field  forms  for  double-buffered  animation 

Remove  the  code  from  the  hive  form’s  constructor  that  sets  the  background  image.  Then  remove  all 
controls  from  both  forms  and  set  their  DoubleBuf  f  ered  properties  to  true.  Finally,  add  a  Paint 
event  handler  to  each  of  them.  Here's  the  handler  for  the  hive  form — the  field  form's  Paint  event  handler 
is  identical,  except  that  it  calls  renderer .  PaintField  ( )  instead  of  Tenderer .  PaintHive  ( ) : 

private  void  HiveForm_Paint (object  sender,  PaintEventArgs  e)  { 

renderer. PaintHive  (e. Graphics) ;  Wake  sure  you  i  j 

youir  wj|| 

The  hive  form  and  field  form  both  need  a  public  renderer  property 

Add  a  public  field  to  the  hive  form  and  the  field  form: 

public  Renderer  renderer; 


There  are  two  places  where  you  create  a  new  Renderer  ( ) :  in  the  open  button  (underneath  a  call  to 
renderer.ResetQ  and  in  the  ResetSimulatorQ  method.  Remove  all  calls  to  renderer.ResetQ,  and  replace  each 
of  the  new  renderer  statements  with  a  call  to  this  new  GreateRendererO  method  that  you’ll  add: 


private  void  CreateRenderer ()  { 

renderer  =  new  Renderer (world,  hiveForm, 
hiveForm. renderer  =  renderer; 
fieldForm. renderer  =  renderer; 

1 


yov  wo«t  need  a  Keset(;  method 
iielaForm)  *  it  •  . 

m  the  renderer  any  more  /\ll  it 

did  was  remove  the  Controls  -from 

the  ■forms,  and  there  won’t  be 

any  Controls  to  remove 


Overhaul  the  renderer  by  removing  control-based  code  and  adding  graphics 

Here’s  what  you  need  to  do  to  fix  the  renderer: 


♦  Remove  the  two  dictionaries,  since  there  aren't  any  more  controls.  And  while  you’re  at  it,  you 
don’t  need  the  BeeControl  any  more,  or  the  Render  ( ) ,  DrawBees  ( ) ,  or  DrawFlowers  ( ) 
methods.. 


*  Add  some  Bitmap  fields  called  Hivelnside,  HiveOutside,  and  Flower  to  store  the  images. 
Then  create  two  Bitmap  [  ]  arrays  called  BeeAnimationLarge  and  BeeAnimationSmall. 
Each  of  them  will  hold  four  bee  pictures — the  large  ones  are  40x40  and  the  small  are  20x20.  Create 
a  method  called  Initializelmages  ( )  to  resize  the  resources  and  store  them  in  these  fields,  and 
call  it  from  the  Renderer  class  constructor. 


★  Add  the  PaintHive  ( )  method  that  takes  a  Graphics  object  as  a  parameter  and  paints  the  hive 
form  onto  it.  First  draw  a  sky  blue  rectangle,  then  use  DrawImageUnscaled  ( )  to  draw  the  inside 
hive  picture,  then  use  DrawImageUnscaled  ( )  to  draw  each  of  the  bees  that  are  inside  the  hive. 

★  Finally,  add  the  PaintField  ( )  method.  It  should  draw  a  sky  blue  rectangle  on  the  top  half 
of  the  form,  and  a  green  rectangle  on  the  bottom  half.  You’ll  find  two  form  properties  helpful 
for  this:  ClientSize  and  ClicntRcctanglc  tell  you  how  big  the  drawing  area  is,  so  you  can  find 
half  of  its  height  using  Cl ientSize  .Height  /  2.  Then  use  FillEllipse  ( )  to  draw  a 
yellow  sun  in  the  sky,  DrawLine  ( )  to  drawr  a  thick  line  for  a  branch  the  hive  can  hang  from,  and 
DrawImageUnscaled  ( )  to  draw  the  outside  hive  picture.  Then  draw  each  flower  onto  the  form. 
Finally,  draw  each  bee  (using  the  small  bee  pictures) — draw  them  last  so  they’re  in  front  of  the  flowers. 

★  When  you’re  drawing  the  bees,  remember  that  AnimateBees  ( )  sets  the  Cell  field. 
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&teRci$e 

§OLut»OM 


It’s  time  to  get  rid  of  the  graphics  glitches  in  the  beehive  simulator.  Use  graphics  and  double 
buffering  to  make  the  simulator  look  polished. 


using  System. Drawing; 


public  class  Renderer  { 
private  World  world; 
private  HiveForm  hiveForm; 
private  FieldForm  fieldForm; 


Here's  the  Complete  Renderer  class,  including  the 
AnimateBeesO  method  that  we  gave  you  Make 
sure  you  make  all  the  modifications  to  the  three 
•forms— especially  the  Paint  event  handlers  in 
the  hive  and  field  forms  Those  event  handlers 
call  the  renderer ’s  PaintHiveO  and  PaintPieldO 
methods,  which  do  all  of  the  animation 


public  Renderer (World  TheWorld,  HiveForm  hiveForm,  FieldForm  fieldForm)  { 
this. world  =  TheWorld; 
this . hiveForm  =  hiveForm; 
this . fieldForm  =  fieldForm; 

Initializelmages ( ) ; 


public  static  Bitmap  Resizelmage (Image  ImageToResize,  int  Width, 
Bitmap  bitmap  =  new  Bitmap (Width,  Height); 
using  (Graphics  graphics  =  Graphics. Fromlmage (bitmap) )  ( 

graphics .Drawlmage (ImageToResize,  0,  0,  Width,  Height); 


int  Height) 


return  bitmap; 


The  InltializelmagesO  method  resizes  all  of 
the  image  resources  and  stores  them  in  Bitmap 

Bitmap  Hivelnside;  ^tr^erer  obje£t  way  the 

Bitmap  HiveOutside;  /P'  PaintHiveO  and  PamtFormO  methods  can  draw 

Bitmap  Flower;  images  unsealed  using  the  forms'  graphics 

Bitmap  []  BeeAnimationSmall;  objects'  DrawImageUnscaledO  methods. 

Bitmap []  BeeAnimationLarge; 
private  void  Initializelmages ( )  ( 

HiveOutside  =  Resizelmage (Properties .Resources .Hive _ outside_,  85,  100); 

Flower  =  Resizelmage (Properties. Resources. Flower,  75,  75); 

Hivelnside  =  Resizelmage (Properties .Resources . Hive _ inside_, 

hiveForm . Cl ientRectangle .Width,  hiveForm . Cl ientRectangle . Height ) ; 
BeeAnimationLarge  =  new  Bitmap [4]; 

BeeAnimationLarge [0]  =  Resizelmage (Properties . Resources . Bee_animation_l , 
BeeAnimationLarge [1]  =  Resizelmage ( Propert ies. Resources. Bee_animation_2, 
BeeAnimationLarge [2]  =  Resizelmage (Properties .Resources. Bee_animation_3, 
BeeAnimationLarge [3]  =  Resizelmage (Properties . Resources. Bee_animation_4, 
BeeAnimationSmall  =  new  Bitmap[4]; 


BeeAnimationSmall [0] 
BeeAnimationSmall [1] 
BeeAnimationSmall [2] 
BeeAnimationSmall [3] 


Resizelmage (Properties .Resources .Bee_animation_l, 
Resizelmage (Properties .Resources .Bee_animation_2, 
Resizelmage (Properties . Resources . Bee_animation_3, 
Resizelmage (Properties . Resources . Bee_animation  4 , 
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) 


public  void  PaintHive (Graphics  g)  { 

g.FillRectangle (Brushes .SkyBlue,  hiveForm.ClientRectangle) ; 
g.DrawImageUnscaled (Hivelnside,  0,  0); 
foreach  (Bee  bee  in  world. Bees)  ( 
if  (bee. InsideHive) 

g.DrawImageUnscaled (BeeAnimationLarge [Cell] , 

bee.Location.X,  bee.Location.Y) ; 


j  A  form's  ClientSiz*  property  is  a  Refrtangle 

tKat  tells  you  how  big  its  drawing  area  is. 

public  void  PaintField(Graphics  g)  { 

using  (Pen  brownPen  =  new  Pen (Color . Brown,  6. OF))  { 
g. FillRectangle (Brushes . SkyBlue,  0,  0, 

fieldForm.ClientSize. Width,  fieldForm.ClientSize. Height  /  2); 
g. FillEllipse (Brushes. Yellow,  new  RectangleF (50,  15,  70,  70)); 
g.FillRectangle (Brushes. Green,  0,  fieldForm.ClientSize. Height  /  2, 

fieldForm.ClientSize .Width,  fieldForm.ClientSize. Height  /  2); 
g. DrawLine (brownPen,  new  Point (643,  0),  new  Point (643,  30)); 
g.DrawImageUnscaled (Hi veOutside,  600,  20); 
foreach  (Flower  flower  in  world. Flowers)  ( 

g.DrawImageUnscaled (Flower,  flower .Location. X,  flower .Location. Y) ; 


> 

foreach  (Bee  bee  in  world. Bees)  { 
if  (! bee. InsideHive) 

g.DrawImageUnscaled (BeeAnimationSmall [Cell] , 

bee.Location.X,  bee.Location.Y) ; 


) 


private  int  Cell  =0; 
private  int  Frame  =  0; 
public  void  AnimateBees ( ) 
< 

Frame++; 
if  (Frame  >=  6) 

Frame  =0; 
switch  (Frame)  ( 


A 


v_ 


case 

0: 

Cell  =  0; 

break; 

case 

1: 

Cell  =  1; 

break; 

case 

2: 

Cell  =  2; 

break; 

case 

3: 

Cell  =3; 

break; 

case 

4; 

Cell  =  2; 

break; 

case 

5; 

Cell  =  1; 

break; 

default 

:  Cell  =  0 

;  break 

) 

hiveForm. Invalidate () ; 
fieldForm. Invalidate ( ) 


TV  fcrfWdO 

£  ^  xz*  *  ri**  ;r 

fcrf J  tt.  Wo,  «*.  «* Wo  '«* 


*  iht  s ,, 
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printing  uses  graphics  too 


Use  a  Graphics  object  and  an  event  handler  for  printing 

Hie  Graphics  methods  you’ve  been  using  to  draw  on  your  forms  are  the  same 
ones  you  use  to  print.  .NET’s  printing  objects  in  System.  Drawing.  Printing 
make  it  really  easy  to  add  printing  and  print  preview  to  your  applications.  All 
you  need  to  do  is  create  a  PrintDocument  object.  It's  got  an  event  called 
PrintPage,  which  you  can  use  exactly  like  you  use  a  timer’s  Tick  event.  Then  call 
the  PrintDocument  object’s  Print  ( )  method  and  it  prints  the  document.  And 
remember,  the  IDE  makes  it  especially  easy  to  add  the  event  handler.  Here’s  how-. 

Start  a  new  Windows  application  and  add  a  button  to  the  form.  (Jo  to  the  form  code 
and  add  a  using  System.  Drawing.  Printing;  line  to  the  top.  Double-click  on  the  button 

and  add  the  event  handler.  Watch  what  happens  as  soon  as  you  type  +=: 


private  void  buttonl_Click (object  sender,  EventArgs  e) 
PrintDocument  document  =  new  PrintDocument () ; 
document. PrintPage  += 


1 


newPrinb>ageEventHandler(docunient_PrintPage)^(p^s^™^^nsert)k 


Press  Tab  and  the  IDE  automatically  fills  in  the  rest  of  the  line.  This  is  just  like  how  you  added 
event  handlers  in  Chapter  1 1 : 


private  void  buttonl_Click (object  sender,  EventArgs  e)  { 

PrintDocument  document  =  new  PrintDocument ( ) ; 

document . PrintPage  +=  new  Print PageEventHandler (document_PrintPage) ; 


As  soon  as  you  press  Tab,  the  IDE  generates  an  event  handler  method  and  adds  it  to  the  form. 

void  document_PrintPage (object  sender,  PrintPageEventArgs  e)  ( 

throw  new  NotlmplementedException  ()  ;  Now  you  tan  fwt  ANY  yifWiCs  Code  Were— jusfc 
j  opiate  tWe  tWrow  line  and  use  e  ^vapW'Cs  -for  all  of 

tWe  drawing  We'll  sWow  you  Wow  in  a  minute  ■ 

The  PrintPageEventArgs  parameter  e  has  a  Graphics  property. Just  replace  the  throw 
statement  with  code  that  calls  the  e .  Graphics  object’s  drawing  methods. 


Now  finish  off  the  buttonl  Click  event  handler  by  calling  document .  Print  () .  When  that 
method  is  called,  the  PrintDocument  object  creates  a  Graphics  object  and  then  (ires  off  a 
PrintPage  event  with  the  Graphics  object  as  a  parameter.  Anything  that  the  event  handler  draws 
onto  the  Graphics  object  will  get  sent  to  the  printer. 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 

PrintDocument  document  =  new  PrintDocument () ; 

document . PrintPage  +=  new  PrintPageEventHandler (document_PrintPage) ; 
document. Print () ; 
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PrintPocuwent  works  with  the  print  dialog 
and  print  preview  window  objects 


Adding  a  print  preview  window  or  a  print  dialog  box  is  a  lot  like  adding  an  open  or  save 
dialog  box.  All  you  need  to  do  is  create  a  PrintDialog  or  PrintPreviewDialog 
object,  set  its  Document  property  to  your  Document  object,  and  then  call  the  dialog's 
Show  ( )  method.  The  dialog  will  take  care  of  sending  the  document  to  the  printer  no 
need  to  call  its  Print  ( )  method.  So  let’s  add  this  to  the  button  you  created  in  step  I : 


private  void  buttonl_Click (object  sender,  EventArgs  e)  ( 

PrintDocument  document  =  new  PrintDocument () ; 

^  document. PrintPage  +=  new  PrintPageEventHandler (document_PrintPage) ; 
PrintPreviewDialog  preview  =  new  PrintPreviewDialog!); 
preview. Document  =  document; 


Ontc  you’ve  3<rt  a 
PrintDodument  and  an 
event  handler  to  feint 
the  paje,  you  tan  pop  up 
a  print  preview  window 
just  by  treating  a  new 
PrintPreviewDialog  object 


preview. ShowDialog  (this) 

void  document  PrintPage (object  sender, 

PrintPageEventArgs  e)  { 

DrawBee (e. Graphics,  new  Rectangle (0,  0,  300,  300)); 

} 

Use  e.Ha$MorePages  to  print  multi-page  documents 

If  you  need  to  print  more  than  one  page,  all  you  need  to  do  is  have  your 
PrintPage  event  handler  set  e.HasMorePages  to  true.  That  tells 
the  Document  that  you’ve  got  another  page  to  print.  It'll  call  the  event 
handler  over  and  over  again,  once  per  page,  as  long  as  the  event  handler 
keeps  setting  e .  HasMorePages  to  true.  So  modify  your  Document's 
event  handler  to  print  two  pages: 


O 


bool  firstPage  =  true; 

void  document_PrintPage (object  sender,  PrintPageEventArgs  e)  { 

DrawBee (e. Graphics,  new  Rectangle (0,  0,  300,  300)); 
using  (Font  font  =  new  Font ("Arial",  36,  FontStyle.Bold) )  ( 
if  (firstPage)  ( 

e. Graphics. Drawstring ("First  page",  Font,  Brushes .Black,  0,  0); 

e . HasMorePages  = 

firstPage  =  false; 

(  el  e  {  ^ — ~  ijdin  TO  prmt  the  next  page 

e. Graphics. Drawstring ("Second  page",  Font,  Brushes. Black,  0,  0); 
firstPage  =  true; 


true;  |f  you  set  e Has/WorePa3eS  to  true  the  Document  object  will  Call 

event  handler  a3ain  to  print  the  next  pacte 


) 


Kow  run  your  program  ayin,  and  »ake  sure  it  s 
displaying  two  pays  in  the  print  preview 
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ttciSe 


Write  the  code  for  the  Print  button  in  the  simulator  so  that  it  pops  up  a  print  preview  window 
showing  the  bee  stats  and  pictures  of  the  hive  and  the  field 


Make  the  button  pop  up  a  print  preview  window 

Add  an  event  handler  for  the  button's  click  event  that  pauses  the  simulator,  pops  up  the  print 
preview  dialog,  and  then  resumes  the  simulator  when  it’s  done.  (If  the  simulator  is  paused  when 
the  button  is  clicked,  make  sure  it  stays  paused  after  the  preview  is  shown.) 


Create  the  document's  PrintPage  event  handler 

It  should  create  a  page  that  looks  exactly  like  the  one  on  the  facing  page.  We’ll  start  you  oil': 


private  void  document_PrintPage (object  sender,  PrintPageEventArgs  e)  ( 
Graphics  g  =  e. Graphics; 

Size  stringSize; 

using  (Font  arial24bold  =  new  Font ("Arial",  24,  FontStyle.Bold) )  { 
We  treated  -the  oval  stringSize  =  Size.Ceiling( 


wibh  te*t  in  rt  usmj 

the  MeasureStrin^Q/ 
method,  which  ' 
returns  3  Sire  that 
Contains  the  sire  of 
a  string  We  drew 
the  oval  and  tent 
twice  to  jive  it  a 
shadow  effeti 


g. Measurestring ("Bee  Simulator",  arial24bold) ) ; 
g . FillEllipse (Brushes . Gray, 

new  Rectangle (e.MarginBounds.X  +  2,  e.MarginBounds.Y  +  2 
stringSize. Width  +  30,  stringSize. Height  +  30)); 
g. FillEllipse (Brushes .Black, 

new  Rectangle(e.MarginBounds.X,  e.MarginBounds.Y, 
stringSize. Width  +  30,  stringSize. Height  +  30)); 
g . Drawstring ("Bee  Simulator",  arial24bold. 

Brushes .Gray,  e.MarginBounds.X  +  17,  e.MarginBounds.Y  + 
g. Drawstring ("Bee  Simulator",  arial24bold. 

Brushes .White,  e.MarginBounds.X  +  15,  e.MarginBounds.Y  + 


17); 

15); 


•int  tableX  =  e.MarginBounds.X  +  (int) stringSize. Width  +  50; 


You'll  need  \int  tableWidth  =  e.MarginBounds.X  +  e.MarginBounds .Width  -  tableX  -  20; 

,  .  J  int  firstColumnX  =  tableX  +  2; 

(*ese  to  build  "S  int  SecondColumnX  =  tableX  +  (tableWidth  /  2)  +  5; 
the  table  (jint  tableY  =  e.MarginBounds.Y; 

//  Your  job:  fill  in  the  rest  of  the  method  to  make  it  print  this 


This  PrintTablcRow()  method  will  come  in  handy 

You’ll  find  this  method  useful  when  you  create  the  table  of  l>ee  stats  at  the  top  of  the  page. 


private  int  PrintTableRow (Graphics  printGraphics,  int  tableX, 

int  tableWidth,  int  firstColumnX,  int  secondColumnX, 
int  tableY,  string  firstColumn,  string  secondColumn)  { 
Font  ariall2  =  new  Font ("Arial",  12); 

Size  stringSize  =  Size. Ceiling (printGraphics .Measurestring (firstColumn, 
tableY  +=  2; 

printGraphics. Drawstring (firstColumn,  ariall2.  Brushes .Black, 
firstColumnX,  tableY) ; 

printGraphics. Drawstring (secondColumn,  ariall2.  Brushes .Black, 
secondColumnX,  tableY) ; 
tableY  +=  (int) stringSize. Height  +  2; 

printGraphics. DrawLine (Pens. Black,  tableX,  tableY,  tableX  +  tableWidth, 


arial 12. Dispose () ; 
return  tableY; 


ariall2) ) ; 


tableY) ; 
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Take  a  close  look  at  the  notes  we  wrote  on  the  printout.  This  is  a  little  complex — take  your  time! 


Bee  Simulator 


Use  -the  FVintfableRowO  method 
to  print  the  rows  of  the  -table  ' 


HoiryH  Hl» 


We  used  e  MarginBounds  to  keep 
a  left  margin  This  ellipse  starts 
at  eWIarginBounds  y.  +  Z 

Use  the  render er  y 

to  draw  the  hive 
form.  Draw  a  blank  f 

rectangle  around 
it  with  a  width  r 
of  Z.  Use  the 

Width  property  mil 
e  MarginBounds  to  "TJJ 

make  it  half  the 

width  of  the  page  ' —  "  ~~ 


Then  use  the 
renderer  to  do 
the  same  for  the 
f  ield  form— make 
it  the  full  page 
width  using  the 
y.  and  V  fields  in 
e  WlarginBounds 
See  if  you  can  give 
them  the  same 
'  proportions  as  the 
two  forms. 


OrCt  you  figure  out  how  tall  to  make  the  hive 
picture,  align  it  to  the  bottom  of  the  page 


Here's  a  hint  To  f  ind  the  height  of  each  form,  f  ind  the  ratio  of  its  height  divided  by  its  width  and 
multiply  that  by  the  final  width,  /ou  can  locate  the  top  of  the  field  form  by  subtracting  its  height 
from  the  bottom  margin  of  the  page-  U  /VlarginBoundsY  +  e  WlarginBounds  Height  -  f  ieldHeight) 
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Write  the  code  for  the  Print  button  in  the  simulator  so  that  it  pops  up  a  print  preview  window 
showing  the  bee  stats  and  pictures  of  the  hive  and  the  field. 


frteRctSe 

Solution 


using  System. Drawing . Printing; 


2®re>ptte  CV^  the  Voern^i 

cveni  It  goes  ,n  the 


private  void  document_PrintPage (object  sender,  Print PageEventArgs  e)  ( 

Graphics  g  =  e. Graphics; 

Size  stringSize; 

using  (Font  arial24bold  =  new  Font  ("Arial",  24,  FontStyle.Bold) )  ( 
stringSize  =  Size. Ceiling ( 

g. Measurestring ("Bee  Simulator",  arial24bold) ) ;  J 

g.FillEllipse (Brushes. Gray,  / 

new  Rectangle (e.MarginBounds.X  +  2,  e .MarginBounds . Y  +  2,  / 
stringSize. Width  +  30,  stringSize. Height  +  30));  C 

g.FillEllipse (Brushes. Black, 

new  Rectangle (e.MarginBounds.X,  e. MarginBounds. Y,  \ 

stringSize. Width  +  30,  stringSize. Height  +  30)); 
g. Drawstring ("Bee  Simulator",  arial24bold, 

Brushes .Gray,  e.MarginBounds.X  +  17,  e. MarginBounds. Y  +  17); 
g. Drawstring ("Bee  Simulator",  arial24bold, 

Brushes .White,  e.MarginBounds.X  +  15,  e. MarginBounds. Y  +  15); 


4/e  T*  ^‘l 

^art  already  It 

draws  the  oval 
header,  and 
sets  enables 

that  'you’ll  use  to 
\  draw  the  table 
\o£  bee  stats 


int  tableX  =  e.MarginBounds.X  +  (int) stringSize. Width  +  50; 
int  tableWidth  =  e.MarginBounds.X  +  e. MarginBounds. Width  -  tableX  -  20; 
int  firstColumnX  =  tableX  +  2;  J 

int  secondColumnX  =  tableX  +  (tableWidth  /  2)  +5;  J 

int  tableY  =  e. MarginBounds. Y;  _ 

pdff>LfTe  oui  how  ihe 

tableY  =  PrintTableRow(g,  tableX,  tableWidth,  firstColumnX,  rrmt  fableKowO  method  works? 

secondColumnX,  tableY,  "Bees",  Bees. Text);  - - II  you  need  to  do  is  call  it 

tableY  =  PrintTableRow (g,  tableX,  tableWidth,  firstColumnX,  °"Ce  per  row,  and  it  prints 

secondColumnX,  tableY,  "Flowers",  Flowers. Text) ;  whatever  text  you  want  in 

tableY  =  PrintTableRow  (g,  tableX,  tableWidth,  firstColumnX,  the  two  Columns.  The  triek 

secondColumnX,  tableY,  "Honey  in  Hive",  HoneylnHive.Text)  ;  that  it  returns  the  nevj  yf 

tableY  =  PrintTableRow  (g,  tableX,  tableWidth,  firstColumnX,  value  -for  the  next  *-ow  ^ 

secondColumnX,  tableY,  "Nectar  in  Flowers",  NectarlnFlowers .Text) ; 
tableY  =  PrintTableRow (g,  tableX,  tableWidth,  firstColumnX, 
secondColumnX,  tableY,  "Frames  Run",  FramesRun.Text) ; 
tableY  =  PrintTableRow (g,  tableX,  tableWidth,  firstColumnX, 
secondColumnX,  tableY,  "Frame  Rate",  FrameRate.Text) ; 


tableY 


g. Dr awRectangle (Pens. Black,  tableX,  e. MarginBounds. Y, 
tableWidth,  tableY  -  e. MarginBounds. Y) ; 
g.DrawLine( Pens. Black,  secondColumnX,  e. MarginBounds .Y, 
secondColumnX,  tableY) ; 


Don’t  foryt  to  draw 

the  retMe  around  the 

table  and  the  W  between 

the  tolumns 
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^ — V^'H  a  black  pen  that's  2  pixels  wide  to 

using  (Pen  blackPen  =  new  Pen  (Brushes  .Black,  2))  draw  the  lines  around  the  screenshots, 
using  (Bitmap  hiveBitmap  =  new  Bitmap (hiveForm.ClientSize. Width,  The  bitmaps  reed  to 

hiveForm.ClientSize. Height) )  V  san«e  size  as 

sing  (Bitmap  fieldBitmap  =  new  Bitmap (fieldForm.ClientSize. Width,  X^eform’ s  drawing 

fieldForm.ClientSize. Height) )  J  so  Client^.** 

tomes  in  hardy 

using  (Graphics  hiveGraphics  =  Graphics. Fromlmage (hiveBitmap) ) 

{  R  V*e  Pain^ive0  "'etKod  needs  a 

'  X - '  praphits  obieet  a-M...  _  . 


Since  the 


fen  and  the 
two  bitmaps 
reed  to  be 
disposed,  we 
P«*t  them  all 
in  one  big 
using  block 


Tenderer. PaintHive (hiveGraphics) 


) 


graphics  object  to  draw  on,  SO  this 
Code  creates  an  empty  Bitmap  object 
ard  passes  it  to  PaintfW). 


int  hiveWidth  =  e .MarginBounds .Width  /  2; 
float  ratio  =  (float) hiveBitmap. Height  /  (float) hiveBitmap. Width; 
int  hiveHeight  =  (int) (hiveWidth  *  ratio); 

int  hiveX  =  e. MarginBounds. X  +  (e. MarginBounds. Width  -  hiveWidth)  /  2; 
int  hiveY  =  e. MarginBounds. Height  /  3; 

g. Drawlmage (hiveBitmap,  hiveX,  hiveY,  hiveWidth,  hiveHeight); 
g.DrawRectangle (blackPen,  hiveX,  hiveY,  hiveWidth,  hiveHeight); 


(Graphics  f ieldGraphics  =  Graphics . Fromlmage (fieldBitmap) ) 

.  e  Marg.nBoundsW.dth  has  the  width  of  the 
'  -printable  area  of  the  page  Thats  how  w.de 
the  field  screenshot  should  be  drawn 


using 

< 

Tenderer . PaintField ( f ieldGraphics ) , 

)  ^ —  rrmT 

int  fieldWidth  =  e. MarginBounds. Width; 
ratio  =  (float) fieldBitmap. Height  /  (float) fieldBitmap. Width; 
int  f ieldHeight  =  (int)  (fieldWidth  *  ratio);  Here's  where  the  he. ght  of  the  screenshot  is 
fieldX  =  e. MarginBounds. X;  _ ^  Calculated  using  the  form's  height-width  ratio. 

tc:  .  Hainht’  —  f  i  p!  HHpi  rThh? 


int 

int  fieldY  =  e. MarginBounds. Y  +  e. MarginBounds. Height  -~f ieldHeight? 
g. Drawlmage (fieldBitmap,  fieldX,  fieldY,  fieldWidth,  f ieldHeight) ; 
g.DrawRectangle (blackPen,  fieldX,  fieldY,  fieldWidth,  fieldHeight) ; 


private  void  printToolStripButton_Click (object  sender,  EventArgs  e)  { 

Here  s  the  Code  for  the  FV.nt  button  It  pauses  the 
simulator  (if  it's  running),  Creates  a  PrintDocument, 
hooks  it  up  to  the  PrintPage  event  handler,  shows 

the  dialog,  and  then  restarts  the  simulator 

PrintPreviewDialog  preview  =  new  PrintPreviewDiaxog ( ) ; 

PrintDocument  document  =  new  PrintDocument () ; 
preview. Document  =  document; 

document . PrintPage  +=  new  PrintPageEventHandler (document_PrintPage) ; 
preview. ShowDialog (this) ; 
if  (stoppedT inter) 
timerl . Start  ( ) ; 

} 


bool  stoppedTimer  =  false; 
if  (timerl .Enabled)  { 
timerl. Stop () ; 
stoppedTimer  =  true; 

) 


you  are  here  ► 
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mini 


There's  so  much  wore  to  be  done... 

You’ve  built  a  pretty  neat  little  simulator,  but  why  slop  now? 

There’s  a  whole  lot  more  that  you  can  do  on  your  own.  Here  are 
some  ideas  see  if  you  can  implement  some  of  them. 

Add  a  control  panel 

Convert  the  constants  in  the  World  and  Hive  classes  to  properties.  Then 
add  a  new  form  with  a  control  panel  that  has  sliders  to  control  them. 


Add  enemies 

Add  enemies  that  attack  the  hive.  The  more  flowers  there  are,  the  more 
enemies  are  attracted  to  the  hive.  Then  add  Sting  Patrol  bees  to  defend 
against  the  enemies  and  Hive  Maintenance  bees  to  defend  and  repair  the 
hive.  Those  bees  take  extra  honey. 

Add  hive  upgrades 

If  the  hive  gets  enough  honey,  it  gets  bigger.  A  bigger  hive  can  hold  more 
bees,  but  takes  more  honey  and  attracts  more  enemies.  If  enemies  cause 
too  much  damage,  the  hive  gets  smaller  again. 

Add  a  queen  bee  who  lays  eggs 

The  eggs  need  Baby  Bee  Care  worker  bees  to  take  care  of  them.  More 
honey  in  the  hive  causes  the  queen  to  lay  more  eggs,  which  need  more 
workers  to  care  for  them,  who  consume  more  honey. 

Add  animation 

Animate  the  background  of  the  Hive  form  so  the  sun  slowly  travels 
across  the  sky.  Make  it  get  dark  at  night,  and  draw  stars  and  a  moon. 
Add  some  perspective-make  the  bees  get  smaller  the  further  they  get 
from  the  hive  in  the  field  of  flowers. 


A  ^ood 

simulation  will 
have  lots  of 
tradeoffs,  and 
will  jive  the 
user  ways  to 
detide  which 
tradeoffs 
to  make  to 
influence  the 
progress  of 
the  hive- 


Use  your  imagination! 

Try  to  think  of  other  ways  you  can  make  the  simulation  more  interesting 
or  more  interactive. 


Did  you  come  up  with  a  cool  modiJication  to  the  simulator?  Show  off 
your  skills— upload  your  project’s  source  code  to  the  Head  First  C# 
Jorums  at  www.headJirstlahs.com/hooks/hlcsharp/. 
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CAPTMN  AflA'ZING 

THliDE^TH 
OF  THETOBJECT 


Head  First  Labs 

$2.98 

Chapter 

14 

I’VE  GOT  you  NOw, 

Swindler. 


READy  TO  WREAK  HAVOC 
ON  THE  STREETS  OF 
OBJECTVILLE!  ^ 


Objectville 


VLL  TARE  DOWN  EACH 
CLONE’S  REFERENCES,  ONE 
By  ONE. 


YOU’RE  TOO  LATE!  AS  wE  SPEAK 
MY  CLONE  ARMY  IS  GATHERING  IN 


THE  FACTORY  BENEATH  US- 


Home  of 


Captain  Amazing,  Objectville's  most 
amazing  object,  pursues  his  arch-nemesis... 
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reenacting  the  crime 


^Sharpen  your  pencil 


Below  is  the  code  detailing  the  fight  between  Captain  Amazing  and  Swindler  (not  to 
mention  his  clone  army).  Your  job  is  to  draw  out  what's  going  on  in  memory  when 
the  FinalBattle  class  is  instantiated. 


You  tdr  assume  that  Clones  was 
using  an  objCtt  initialiser. 


what  s  goin-  ~  •  '  ■ 
factory  object 


public  class  FinalBattle  { 

public  CloneFactory  Factory  =  new  CloneFactory!); 
public  List<Clone>  Clones  =  new  List<Clone> ( ) ; 
public  SwindlersEscapePlane  escapePlane; 

public  FinalBattle!)  { 

public  Villain  swindler  =  new  Villain (this) ; 
using  (Superhero  captainAmazing  =  new  Superhero!))  ( 

Factory . PeoplelnFactory. Add (captainAma^yig) ; 

Factory . PeoplelnFactory . Add (swindler) ; 

captainAmazing. Think ("I' 11  take  down  each  of  the  clones'  references, 

one  by  one" ) ; 

captainAmazing. IdentifyTheClones (Clones) ; 
captainAmazing. RemoveTheClones (Clones) ; 

swindler. Think ("A  few  minutes  from  now,  you  AND  my  army  will  be  garbage"); 
swindler .Think (" (collected,  that  is!)"); 
escapePlane  =  new  SwindlersEscapePlane (swindler) ; ^ 
swindler .TrapCaptainAmazing (Factory) ; 

MessageBox. Show ("The  Swindler  escaped"); 

j  _ Vra™  a  Kture  of  what  the  heap  will  look  like  exactly 

)  W  one  second  after  the  FinalBattle  Constructor  runs. 

[Serializable] 

public  class  Superhero  :  IDisposable  { 

private  List<Clone>  clonesToRemove  =  new  List<Clone> () , 
public  void  Identif yTheClones (List<Clone>  clones)  { 
foreach  (Clone  clone  in  clones) 
clonesToRemove. Add (clone) ; 

) 

public  void  RemoveTheClones (List<Clone>  clones)  ( 
foreach  (Clone  clone  in  clonesToRemove) 
clones. Remove (clone) ; 

There’s  more  Code  here  (including  the 


pv-aw  what's  going  on 
right  here,  when  the 
SwindlersEscapePlane 
object  is  instantiated 


) 


DisposeO  method)  that  we  aren’t  showing 
(  you,  but  you  don’t  need  it  to  answer  this. 


) 

public  class  Villain 

private  FinalBattle  finalBattle; 

public  Villain (FinalBattle  finalBattle)  { 
this. finalBattle  =  finalBattle; 

> 

public  void  TrapCaptainAmazing (CloneFactory  factory)  ( 

factory .Self Destruct. Tick  +=  new  EventHandler (Self Destruct_Tick) ; 
factory. SelfDestruct . Interval  =  600; 
factory . SelfDestruct . Start ( ) ; 

) 

private  void  Self Destruct_Tick (object  sender,  EventArgs  e)  { 
finalBattle. factory  =  null; 

) 

) 
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ad  CiHct  r# 


public  class  SwindlersEscapePlane  { 
public  Villain  PilotsSeat; 

public  SwindlersEscapePlane (Villain  escapee)  { 
PilotsSeat  =  escapee; 


public  class  CloneFactory  { 

public  Timer  SelfDestruct  =  new  Timer (); 

public  List<object>  PeoplelnFactory  =  new  Listcobj 


There’s  a  clone  tlass 
and  that  x're 

showing  You.m 

Code  too  Y°«  d®"  t 
*«d  rt  to  answer  the 

questions  \ 

jectX) 


Wake  sune  you  add 
labels  to  your  objects 
to  show  the  reference 
variables  that  are 
pointing  to  them 


■  kVe  started  the  f  irst  for  you  Wake  sure  you 
draw  in  lines  showing  the  architecture — we  drew 
a  line  from  the  clone  factory  to  the  Superhero 
object,  because  the  factory  has  references  to  it 
(via  its  PeoplelnFactory  field) 


I 

We've  left  space,  as  there  is 
more  to  be  drawn  at  this  sta«e 

List  objects,  andW  ^+J* 


'  Your  job  is  to  draw  what's 
3*9  on  in  these  two  bits 
or  memory,  too 


Based  on  your  diagrams,  where  in  the  code  did  Captain  Amazing  die? 


Be  sure  and  annotate  that  on  your  diagram,  too. 


hmm...  i  wonder  what  those  numbers  say 


Draw  what's  happening  in  memory  with  the  FinalBattle  program. 


O 

As  long  as  there's  a 
reference  to  swindler 
“from  the  escapePlane, 
he  won't  yt  garbage 
Collected 


Points  to  a  villain  object,  and  the  done 

Storys  PeoplelnFactory  |«t  Contains 
references  to  both  of  then.. 


The  escapePlane 
reference  now 
points  to  a  new 
instance  of  the 
SwindlersEsCapePlane 
object,  and  its 
PilotSeat  -field 

points  to  the 
l/illain  object 


o 

Here's  the 

object  ^ 

should  have 
added  to  this 

diagram 


O 


ESCAPE 

PLANE 


'frier 


Based  on  your  diagrams,  where  in  the  code  did  Captain  Amazing  die? 
void  Self  pcstrufit_Tick(ob\€dt  sender,  EyentArgse)  { 

^  .77. .W»!i . 


IVhen  the  selfDestruct  fires,  the  factory  reference 
variable  is  set  to  null,  and  eligible  for  garbage 
Collection.  So  it's  gone  in  this  drawing. 

As  soon  as  the  factory  reference  was  gone,  it 
took  the  CloneFactory  object  with  it— and 
that  caused  the  List  object  referenced  by  its 
PeoplelnFactory  field  to  disappear  and  that 
was  the  only  thing  keeping  the  SuperHero  object 
alive  Now  he’ll  be  destroyed  the  ne*t  time  the 
garbage  Collector  runs. 


j  if  4 -rr  the 


Once  finalBattleFactory  was  set  to  null,  it  was  ready  for  garbage 
collection.  And  it  took  the  last  reference  to  the  Captain  with  it! 
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OnCe  the  Superhero  instance  had  no 
clone  factory  referencing  it,  it  was 
marked  for  garbage  collection  too 


osd  Cinot  r# 
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godzilla  versus  destructor 


Your  last  chance  to  PO  something... 
your  object's  finalizer 


Someliines  you  need  to  be  sure  something  happens  before  your  object  gets 
garbage  collected.  You  might  want  to  release  connections  or  resources...  or 
perhaps  send  a  coded  message  to  the  world. 

A  special  method  in  your  object  called  the  finalizer  allows  you  to  write  code 
that  will  always  execute  when  your  object  is  destroyed.  Think  of  it  as  your 
object’s  personal  finally  block:  it  gets  executed  last,  no  matter  what. 

Here’s  an  example  of  a  destructor  in  the  Clone  class: 


[Serializable] 
public  class  Clone  { 
string  Location; 
int  ClonelD; 


Here's  the  Constructor  It  looks  ',ke 
the  ClonelD  and  Location  -fields  are 
populated  anytime  a  Clone  gets  treated 


public  Clone  (int  clonelD,  string  location) { 
this. ClonelD  =  clonelD; 
this .Location  =  location; 

1 


public  void  TellLocation (string  location,  int  clonelD) { 

Console .WriteLine ("My  Identification  number  is  (0)  and  "  + 

"you  can  find  me  here:  {1}.",  clonelD,  location) 


> 


public  void  WreakHavoc (){...} 

^lone()  { 

TellLocation (this . Location, 
Console .WriteLine  ("{0}  has 

} 


This  -  (or  "tilde”)  tharatter  says 
that  the  tode  in  this  blotk  sets  run 
when  the  objett  is  garbage  to lletted- 


this . ClonelD) ; 
been  destroyed", 


ClonelD) 


li 


fh«  is  the  final, 


li  sends  a 


message  to 


the  villain  telling  the 

^dlP.  But  it  will  only 
run  when  the  object  is 
garbage  Collected. 


You  write  a  finalizer  method  just  like 
a  constructor,  but  instead  of  an  access 
modifier,  you  pul  a  ~  in  front  of  the 
class  name.  That  tells  .NET  that  the 
code  in  the  finalizer  block  should  be 
run  any  time  it  garbage  collects  the 
object. 

Additionally,  finalizers  can't  have 
parameters,  since  .NET  calls  this 
object,  rather  than  any  other  object. 


Destructors  and  finalizers  are  the  same 
thing. 


wr  I  f  .  .y  Sometimes  you’ll  hear  people  refer  to  an  object's 
WulLn  It.  Finalizer  method,  and  sometimes  to  its  destructor. 

Both  of  those  terms  refer  to  a  method  that  runs 
when  an  object  is  garbage  collected.  “ Finalizer "  is  generally 
replacing  "destructor"  as  the  name  for  this.  We  ll  use  "destructor” 
a  few  times,  just  because  some  of  the  IDE’s  error  messages  do. 
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the  death  of  an  object 


When  EXACTLY  does  a  finalizer  run? 


The  finalizer  you  build  for  your  object  runs  when  that 
object  gets  garbage  collected.  And  garbage  collection 
happens  after  all  references  to  your  object  go  away.  But 
garbage  collection  doesn't  always  happen  right  after  the 
references  are  gone. 

Suppose  you  have  an  object  with  a  reference  to  it. 

.NET  sends  the  garbage  collector  to  work,  and  it  checks 
out  your  object.  But  since  there  are  references  to  your 
object,  the  garbage  collector  ignores  it  and  moves  along. 
Your  object  keeps  liv  ing  on  in  memory. 

Then,  something  happens.  That  last  object  holding  a 
reference  to  your  object  decides  to  move  on.  Now;  your 
object  is  silting  in  memory,  with  no  references.  It  can’t 
be  accessed.  It's  basically  a  dead  object. 

But  here’s  the  thing.  Garbage  collection  is 
something  that  .NET  controls,  not  your  objects.  So 
if  the  garbage  collector  isn't  sent  out  again  for,  say.  a 
few  seconds,  or  maybe  even  a  few  minutes,  your  object 
still  lives  on  in  memory.  It's  unusable,  but  it  hasn't  been 
garbage  collected.  And  any  finalizer  your  object 
has  does  not  (yet)  get  run. 

Finally,  .NET  sends  the  garbage  collector  out  again. 

This  time,  your  object  is  dead,  and  the  collector  losses 
it  away.  Here,  finally,  your  destructor  runs...  possibly 
several  minutes  alter  the  last  reference  to  the  object  was 
removed  or  changed. 

You  can  SUREST  to  .NET  that  it's 
time  to  collect  the  garbage 

.NET  does  let  you  suggest  that  garbage  collection  would 
be  a  good  idea.  Most  times,  you’ll  never  use  this 
method,  because  garbage  collection  is  tuned  to 
respond  to  a  lot  of  conditions  in  the  CLR  and 
calling  it  isn’t  really  a  good  idea.  But  just  to  see  howr 
a  finalizer  works,  you  could  call  for  garbage  collection 
on  your  own.  If  that’s  what  you  want  to  do,  just  call 
GC. collect  ().  — ■ — 


The  Heap 


-bu-fc  now 


public  void  RemoveTheClones ( 

List<Clone>  clones)  { 
foreach  (Clone  clone  in  clonesToRemove) 
clones .Remove (clone) ; 

GC. Collect () ; 


Be  careful,  though.  That  method  doesn't  force  .NET 
to  garbage  collect  things  immediately.  It  just  says,  “Do 
garbage  collection  as  soon  as  possible.” 


you  are  here  > 
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collect  the  garbage 


Pisposel)  works  with  using, 
finalizers  work  with  garbage  collection 

Dispose  ( )  runs  whenever  an  object  that  is  created  in  a  using  statement  is  set 
to  null  or  loses  all  of  its  references.  If  you  don’t  use  a  using  statement,  then  just 
setting  the  reference  to  null  won’t  cause  Dispose  ( )  to  get  called — you’ll  need 
to  call  it  directly.  An  object’s  final izer  runs  at  garbage  collection  for  that  particular 
object.  I.et's  create  a  couple  of  objects,  and  see  how  these  two  methods  differ: 


Create  a  Clone  class  and  make  sure  it  implements  IDisposable. 

The  class  should  have  one  int  automatic  property  called  ID.  It  has  a 
constructor,  a  Dispose  ( )  method  and  a  finalizer: 

public  class  Clone  :  IDisposable  { 

public  int  ID  (  get;  private  set;  } 

the  class  implements 

PUblthis!lDe-iID; ID>  ***•*«• 

PisyoseO  method 


} 


public  void  Dispose ()  { 

MessageBox. Show ("I've  been  disposed!", 

"Clone  #"  +  ID  +  "  says..."); 

} 


Here's  the  f -nal.zer.  |t  will  run  when  the 
-Clone  ( )  {  •V*  tweeted 

MessageBox. Show ("Aaargh!  You  got  me!' 

says . . 


"Clone  #"  +  ID  + 


} 


Here's  the  W  Y°“ 
_  should  Create 

Create  a  Form  with  three  buttons. 

Create  one  instance  of  Clone  inside  the  Click  handler  for  the  first  button 
with  a  using  statement.  Here’s  the  first  part  of  the  code  for  the  button: 


The  method 
creates  a 
new  Clone 
and  then 
immediately 
kills  it  by 
taking  away 
i-ts  re-ferenCe 


private  void  clonel_Click (object  sender,  EventArgs  e) 
using  (Clone  clonel  =  new  Clone(l))  { 

- ^  //  Do  nothing! 


1 


Since  we  declared  clonel 
with  a  using  statement,  its 
PisposeO  method  gets  run 


/Issoo  a,the  using  block  is  done 
»d  -the  Clone  object's  Pispo se0 
^ihod  is  called,  there's  no  more 

fL*™ ^  Jhd  jeb  marked 
W  3^*»ge  Collection. 
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the  death  of  an  object 

Implement  the  other  two  buttons. 

Create  another  instance  of  Clone  in  the  second  button’s  Click  handler, 
and  set  it  to  null  manually: 


private  void  clone2  Click (object  sender,  EventArgs  e)  { 
Clone  clone2  =  new  Clone (2); 
clone2  =  nuJT;  Sinde  this  doesn't  use  a  using 

- ^  rtate»e»rt,  DisposeO  won’t  ever  yt 

run,  but  the  finalizer  will 


For  the  third  button,  add  a  call  to  GC . Collect  ( )  to  suggest 
garbage  collection  occur. 


private  void  gc_Click (object  sender 
GC. Collect  ()  ; 

)  ^  This  suggests  that 


garbage  dolledtion  run 


Run  the  program  and  play  with  DisposeO  and  finalizers. 

Click  on  the  first  button  and  check  out  the  message  box:  Dispose  ( )  runs  first 


EventArgs  e)  { 

Remember,  normally  it’s  not 
^  a  great  idea  to  do  this.  But 
it’s  -fine  here,  bedause  it’s 
a  good  way  to  learn  about 
garbage  dolledtion- 


I've  been  disposed! 


OK 


Eveh  the  Clone/ 

objedt  has  been  set  to  null 
and  **  Z>isP°*  method  has 
ruh;  *«/Ml  on  the  heap 

'■tf't.ng  &r  garbage  dolledti, 


In  most  cases,  you  ivon ’t  see  the  garbage  collection 
message  box.  Because  your  object  is  set  to  null,  but 
garbage  collection  hasn’t  run  yet. 

Now  click  on  the  second  button...  Nothing  happens,  right? 
That’s  because  we  didn’t  use  a  using  statement,  so  no 
Dispose  ( )  method.  And  until  the  garbage  collector  runs, 
you  won't  see  the  message  boxes  from  the  finalizer. 

Now  click  the  third  button,  to  suggest  garbage  collection. 

You  should  see  the  finalizer  from  both  Clonel  and  Clone2 
fire  up  and  display  message  boxes. 


%el 

The  Heap 

[slow  Clone2- 
is  on  the  .  — ■  V 
heap,  too,  ^ 
^.thout  any 

veferendes 

ip  it- 


%e2 


The  Heap 


Aaargh!  You  got  me! 

Aaargh!  You  got  me! 

OK 

OK  | 

\  |  /  ^  1  ^ 
_  poof!  -  "  P00f!  ~ 

^  /  1  N 

The  Heap 


I  \ 


A 

^  When  ColledtO  is  run,  both  objedts  run 
their  -finalizers  and  disappear 

Play  around  with  the  program.  Click  the  Clone  #  I  button,  then  the  Clone  #2  button,  then  the  GC 
button.  Do  it  a  few  times.  Sometimes  clone  #1  is  collected  lu  st,  and  sometimes  clone  #2  is.  .And  once  in  a 
while,  the  garbage  collector  runs  even  though  you  didn't  ask  it  to  using  GC.CollectQ. 


you  are  here  ► 


631 


an  unstable  environment 


Let’s  say  you’ve  got 
two  objects  that  have 
references  to  each  other... 


Finalizers  can't  depend  on  stability 


When  you  write  a  finalizer,  you  can’t  depend 
on  it  running  at  any  one  time.  Even  if  you  call 
GC .  Collect  ( )  — which  you  should  avoid,  unless 
you  have  a  really  good  reason  to  do  it — you’re  only 
suggesting  that  the  garbage  collector  is  run.  It’s  not  a 
guarantee  that  it’ll  happen  right  now.  And  when  it  does, 
you  have  no  way  of  know  ing  what  order  the  objects  will 
be  collected. 

So  what  does  that  mean,  in  practical  terms?  Well,  think 
about  what  happens  if  you've  got  two  objects  that  have 
references  to  each  other.  If  object  #1  is  collected  first, 
then  object  #2’s  reference  to  it  is  pointing  to  an  object 
that’s  no  longer  there.  But  if  object  #2  is  collected 
first,  then  object  #l's  reference  is  invalid.  So  what  that 
means  is  that  you  can’t  depend  on  references  in 
your  object’s  finalizer.  Which  means  that  it’s  a  really 
bad  idea  to  try  to  do  something  inside  a  finalizer  that 
depends  on  references  lx-ing  valid. 

Serialization  is  a  really  good  example  of  something  that 
you  shouldn’t  do  inside  a  finalizer.  If  your  object’s 
got  a  bunch  of  references  to  other  objects,  serialization 
depends  on  all  of  those  objects  still  being  in  memory... 
and  all  of  the  objects  they  reference,  and  the  ones  those 
objects  reference,  and  so  on.  So  if  you  try  to  serialize 
when  garbage  collection  is  happening,  you  could  end 
up  missing  vital  parts  of  your  program  because  some 
objects  could’ve  been  collected  before  the  finalizer  ran. 

Luckily,  C#  gives  us  a  really  good  solution  to  this: 

I  Disposable.  Anything  that  could  modify  your  core 
data  or  that  depends  on  other  objects  being  in  memory 
needs  to  happen  as  part  of  a  Dispose  ( )  method,  not 
a  finalizer. 

Some  people  like  to  think  of  a  finalizers  as  a  kind  of 
failsafe  for  the  Dispose  ( )  method.  And  that  makes 
sense  you  saw  w  ith  your  Clone  object  that  just  because 
you  implement  IDisposable,  that  doesn't  mean  the 
object's  DisposcQ  method  will  get  called.  But  you  need 
to  be  careful — if  your  Dispose0  method  depends  on 
other  objects  dial  are  on  the  heap,  then  calling  DisposeQ 
from  your  finalizer  can  cause  trouble.  The  best  way 
around  this  is  to  make  sure  you  alw  ays  use  a  using 
statement  any  time  you’re  creating  an  IDispoablc 
object. 


...if  they’re  both  marked  for  garbage 
collection  at  the  same  time,  then 
object  #1  could  disappear  first... 


...on  the  other  hand,  object  #2  could 
disappear  before  object  #1.  You’ve 
got  no  way  of  knowing  the  order... 


...and  that’s  why  one  object’s 
finalizer  can’t  rely  on  any  other 
object  still  being  on  the  heap. 


632  Chapter  14 


the  death  of  an  object 


Make  an  object  serialize  itself  in  its  PisposeO 


Once  you  understand  the  difference  between  l)ispose()  and  a 
finalizer,  it’s  pretty  easy  to  write  objects  that  serialize  themselves  out 
automatically  when  they’re  disposed  of. 


Make  the  Clone  class  (from  page  630)  Serializable. 

Just  add  the  Scrializeable  attribute  on  top  of  the  class  so  that  we  can  save  the  file  out. 

[Serializable] 

public  class  Clone  :  IDisposable 


4- 


Modify  Clone's  Dispose()  method  to  Serialize  itself  out  to  a  file. 

Let’s  use  a  BinaryFormatter  to  write  Clone  out  to  a  file  in  Dispose  ( ) : 

using  System.  10;  - - 

using  System. Runtime. Serialization. Formatters. Binary; 

II  existing  code 


You’ll  need  3 
few  more  using 
statements  to 
access  the  1/  0 
classes  we  II  use 


public  void  Dispose ()  { 

string  filename  =  "C: \\Temp\ \Clone.dat" ; 
string  dirname  =  "C: \\Temp\\"; 
if  (File. Exists (filename)  ==  false)  { 
Directory .CreateDirectory (dirname) ; 


1 


BinaryFormatter  bf  =  new  BinaryFormatter () ; 
using  (Stream  output  =  File. OpenWrite (filename) ) 
bf . Serialize (output,  this); 

} 

MessageBox. Show ("This  is  "  +  this. ID  + 

"  must.,  serialize. .object."); 


^>'S  is  straight 
serialization,  although  y* 
do  hardcode  in  the  -file, 
s'*£e  DuposcO  can't  take 
Jny  parameters 

You  could  set  a  class 
like  this  up  to  take  in  a 
•filename  to  write  itself 
to  in  its  Constructor 


Run  the  application. 

You'll  see  the  same  behavior  you  saw'  on  the  last  few  pages...  but  before  the  Clonel 
object  is  garbage  collected,  it's  serialized  to  a  file.  Look  inside  the  file  and  you'll  see  the 
binary  representation  of  the  object. 


r-  - 

POWEtt 

What  do  you  think  the  rest  of  the  SuperHero 
object’s  code  looked  like?  We  showed  you  part  of  it 
on  page  624.  Could  you  write  the  rest  now? 


you  are  here  ► 
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what  happened  to  the  captain? 


Fireside  Chats 


Tonight's  talk:  The  DisposeO  method  and  a  finalizer  spar 
over  who’s  more  valuable. 


Dispose: 

To  be  honest.  I'm  a  little  surprised  I  was  invited  here. 

I  thought  die  programming  world  had  come  to  a 
consensus.  I  mean.  Pm  way  more  valuable  than  you 
are.  Really,  you’re  pretty  feeble.  You  can’t  even  serialize 
yourself  out,  alter  core  data,  anything.  Pretty  unstable, 
aren’t  you? 


There’s  an  interface  specifically  because  I’m  so 
important.  In  fact,  I’m  the  only  method  in  it! 


OK,  you’re  right,  programmers  need  to  know  they’re 
going  to  need  me  and  either  call  me  directly  or  use  a 
using  statement  to  call  me.  But  they  always  know  when 
I’m  gonna  run,  and  they  can  use  me  to  do  whatever  diey 
need  to  do  to  clean  up  after  their  object.  Pm  powerful, 
reliable,  and  easy'  to  use.  I’m  a  triple  threat.  And  you? 
Nobody  knows  exactly  when  you’ll  run  or  what  the  state 
of  the  application  will  be  when  you  finally  do  decide  to 
show  up. 


So  there’s  basically  nodiing  you  can  do  that  I  can’t  do. 
But  you  think  you’re  a  big  shot  because  you  run  when 
garbage  collection  happens. 


Finalizer: 


Excuse  me?  That’s  rich.  I’m  feeble...  OK.  Well,  1  didn’t 
want  to  get  into  this,  but  since  we’re  already  stooping 
this  low...  at  least  1  don't  need  an  interface  to  get  started. 
Without  I  Disposable,  you’re  just  another  useless 
method. 


Right,  right...  keep  telling  yourself  that.  And  what 
happens  when  someone  forgets  to  use  a  using 
statement  when  they  instantiate  their  object?  Then 
you’re  nowhere  to  be  found. 


-  y rogrdms  we  WhCl 

they  go  around  UtT  and  the  CLR  and 
interact  directly  with  Windows  Since 
MT  doesn't  know  about  them,  it  can't 
clean  them  up  -for  you 


OK,  but  if  you  need  to  do  something  at  the  very  last 
moment  when  an  object  is  garbage  collected,  there’s  no 
way  to  do  it  without  me.  1  can  free  up  network  resources 
and  windows  handles  and  streams  and  anything  else  that 
might  cause  a  problem  for  the  rest  of  the  program  if  you 
don’t  clean  it  up.  I  can  make  sure  that  your  objects  deal 
with  being  trashed  more  gracefully,  and  that’s  nothing  to 
sneeze  at. 
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I’ll  take  that  over  your  flash  and  attitude  any  day,  pal. 


therei  ore  tiQ 

Dumb  Questions 


„•  Can  a  finalizer  use  all  of  an  object's  fields  and  methods? 

Sure.  While  you  can't  pass  parameters  to  a  finalizer  method, 
you  can  use  any  of  the  fields  in  an  object,  either  directly  or  using 
this— but  be  careful,  because  if  those  fields  reference  other 
objects,  then  the  other  objects  may  have  already  been  collected  But 
you  can  definitely  call  other  methods  in  the  object  being  finalized  (as 
long  as  those  methods  don’t  depend  on  other  objects). 

o 

What  happens  to  exceptions  that  get  thrown  in  a  finalizer? 

j\'.  Good  question.  It's  totally  legal  to  put  a  try/catch  block 
inside  a  finalizer  method  Give  it  a  try  yourself.  Create  a  divide  by 
zero  exception  inside  a  try  block  in  the  Clone  program  we  just 
wrote.  Catch  it  and  throw  up  a  message  box  that  says  "I  just  caught 
an  exception '  right  before  the  “...I’ve  been  destroyed.”  box  we’d 
already  wntten.  Now  run  the  program  and  click  on  the  first  button 
and  then  the  GC  button.  You’ll  see  both  the  exception  box  and  the 
destroyed  box  pop  up.  (Of  course,  it  generally  a  really  bad  idea  to 
pop  up  message  boxes  in  finalizers  for  objects  that  are  more  than 
just  toys...  and  those  message  boxes  may  never  actually  pop  up.) 


(V 

How  often  does  the  garbage  collector  run  automatically? 

I \ There's  no  good  answer  to  that  one.  It  doesn't  run  on  an  easily 
predictable  cycle,  and  you  don’t  have  any  firm  control  over  it  You 
can  be  sure  it  will  be  run  when  your  program  exits  But  if  you  want  to 
be  sure  it’ll  run,  you  have  to  use  GC.CollectQ  to  set  it  off.,  and  even 
then,  timing  is  an  issue 

Qj  How  soon  after  I  call  GC.Collect()  will  NET  start  garbage 
collection? 

When  you  run  GC. Collect  ( ) ,  you're  telling  NET  to 
garbage  collect  soon  as  possible.  That's  usually  as  soon  as  NET 
finishes  whatever  its  doing.  That  means  it'll  happen  pretty  soon,  but 
you  can't  actually  control  when. 

o 

If  I  absolutely  need  something  to  run,  I  put  it  in  a  finalizer, 

right? 

It’s  possible  that  your  finalizer  won't  run  It  s  possible  to 
suppress  finalizers  when  garbage  collection  happens.  Or  the  process 
could  end  entirely  But  as  a  general  rule,  your  finalizer  should  run. 
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CAPTAIN  AMAZING. 
HES  BACK! 


CAPTAIN  AMAZING  TOOK  SO  LONG 
TO  GET  HERE  THAT  MR  FLUFFY 
RESCUED  HIMSELF  FROM  THE  TREE... 


'But  SOMETHINGS  WRONG-  He 
DOESN’T  SEEM  THE  SAME...  AND 
HIS  POWERS  ARE  WEIRD.  . 


Meanwhile,  on  the  streets  of  Objectville... 


Even  later.. 


s*<, 


What’s  wrong?  Why  are  the 
Captain's  powers  behaving 
differently?  Is  this  the  end? 


the  death  of  an  object 


A  struct  looks  like  an  object... 


One  of  the  types  in  .NET  we  haven’t  talked  about  much  is  the  struct, 
struct  is  short  for  structure,  and  structs  look  a  lot  like  objects. 
They  have  fields  and  properties,  just  like  objects.  And  you  can  even  pass 
them  into  a  method  that  takes  an  ob  j  ect  type  parameter: 

public  struct  AlmostSuperhero  :  IDisposable  { 
public  int  SuperStrength; 

public  int  SuperSpeed  (  get;  private  set; 


Strutts  tan  implement 
interfaces  but  tan  t 
subtlass  other  t lasses 


A  strutt  tan  have 
properties  and  fields... 


public  void  RemoveVillain  (Villain  villain)  *  ad  define  methods 


Console .WriteLine ("OK,  "  +  villain. Name  + 

"  surrender  and  stop  all  the  madness!"); 
if  (villain. Surrendered) 
villain. GoToJail () ; 


) 


else 

villain. Kill () ; 


public  void  Dispose  ()  {  ...  ) 

} 

..but  isn't  oh  the  heap 

But  structs  aren't  objects  on  the  heap.  They  can  have  methods  and 
fields,  but  they  can’t  have  tinalizers.  They  also  can’t  inherit  from  other 
classes  or  structs,  or  have  classes  or  structs  inherit  from  them. 


The  power  ol  objects 
lies  in  their  ability 
to  mimic  real-world 
behavior,  through 
inheritance  and 
polymorphism. 


strutts  tan’t  mher.t 
from  other  object^ 


'  struct  \ 


You  Can  mimie  a 

standalone  object 
*iih  a  struct,  but 
strudts  don't  stand  in 
«ry  well  for  Complex 
inheritance  hierarchies 


Structs  are  best  used 
lor  storing  data,  hut 
are  not  as  uselul 
as  objects  when  it 
comes  to  representing 
actual  behavior. 


you  are  here  ► 
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makin’  copies 


Values  get  copied,  references  get  assigned 


You  already  have  a  sense  of  how  some  types  are  diflerenl  than  others.  On  one  hand 
you’ve  got  value  types  like  int.  bool,  and  string.  On  the  other  hand,  you’ve  got 
objects  like  List,  Stream,  and  Exception.  And  they  don’t  quite  work  exactly 
the  same  way,  do  they? 

When  you  use  the  equals  sign  to  set  one  value  type  variable  to  another,  it  makes  a 
copy  of  the  value,  and  afterwards  the  two  variables  aren't  connected  to  each  other. 
On  the  other  hand,  when  you  use  the  equals  sign  with  references,  what  you’re  doing  is 

pointing  both  references  at  the  same  object. 


Were  s  a  <y»ick  refresher 
^lue  types  vs.  objects. 


on 


1 1 


V  ariable  declaration  and  assignment  works  the  same  with 

value  types  or  object  tvpcs:  .  .  ,  ,  . 

^ _  int  and  strir»5  are  value  types,  List 

int  howMany  =  37;  and  Exception  are  object  types 

string  name  =  "Fingers";  Tb  a  II 

List<float>  temperatures  =  new  List<float>  () ;  .  f*,  *''*.* 

Exception  ex  =  new  Exception  ("Does  not  compute");  ,BI  m  ^  e 

same  basic  way. 


Charvyr'5  the 
fifteen/Vlore 
variable  has  - 
no  effect  on 
how/V|any,  and 
vice  versa 
C _ 


Differences  creep  in  when  you  start  to  assign  values,  though.  Value  types  all  are 

handled  with  copying.  Here’s  an  example:  _ This  line  Copies  the  value  that's  stored 

the  -fi-fteen/VJore  variable  into  the 

int  fifteenMore  =  howMany;  how/Vlany  variable  and  adds  15  to  it 

_ ^.fifteenMore  +=  15; 

Console .WriteLine ("howMany  has  (0),  fifteenMore  has  (1)", 

howMany,  fifteenMore) ; 

The  output  here  shows  that  fifteenMore  and  howMany  are  not  connected: 

^  howMany  has  25,  fifteenMore  has  40 


With  object  assignments,  though,  you’re  assigning  references,  not  actual  values: 


temperatures .Add (56 . 5F) ; 

This  line  sets  the  temperatures  .  Add(27 . 4F)  ; 
differentList  List<f loat>  dif f erentList  =  temperatures; 

re-ferenCe  to  point  dif  ferentList .  Add  (62 . 9F)  ; 

to  the  same  object 
as  the  temperatures 
reference 

So  changing  the  List  means  both  references  see  the 
update...  since  they'  both  point  to  a  single  List  object. 


Both  references 
pomt  at  the  same 
actual  object 


o  I  FFERENTL  I  ST 


•'st<  pocrt7 


Console. WriteLine ("temperatures  has  {0},  dif ferentlist  has  {1}", 

temperatures .Count ( ) ,  dif f erentList .Count ( ) ) ; 

The  output  here  demonstrates  that  di  f  f erentList  and  W/hen  you  called  differentList-AddO, 

temperatures  are  actually  pointing  to  the  same  object:  ^  added  a  new  temperature  to  the 

L  -,i  i-Ual.  both  differentList  and 

temperatures  has  3,  dif ferentList  has  3  object  t 

*“  temperatures  point  to 
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the  death  of  an  object 


Structs  are  value  types:  objects  are  reference  types 


When  you  create  a  struct,  you’re  creating  a  value  type  W  hat  that 
means  is  when  you  use  equals  to  set  one  struct  variable  equal  to 
another,  you’re  creating  a  fresh  copy  of  the  struct  in  the  new  variable.  So 
even  though  a  struct  looks  like  an  object,  it  doesn’t  act  like  one. 


4- 

r 


4 

Do  this 


Create  a  struct  called  Dog 

Here’s  simple  struct  to  keep  track  of  a  dog  It  looks  just  like  an  object,  but  it’s  not. 


* 


public  struct  Dog  ( 
public  string  Name; 
public  string  Breed; 


Yes,  this  is  not  $ood 
Bear  with  us— w«  re 


encapsulation 

making  a  point 


public  Dog (string  name,  string  breed)  { 
this. Name  =  name; 
this. Breed  =  breed; 

) 


public  void  Speak ()  { 

Console. WriteLine ("My  name  is  (0)  and  I'm  a  (1}.",  Name,  Breed); 

) 


Create  a  class  called  Canine 

Make  tin  exact  copy  of  the  Dog  struct,  except  replace  struct  with  class  and  then 
replace  Dog  with  Canine.  Now  you’ll  have  a  Canine  class  that  you  can  play  with, 
which  is  almost  exactly  equivalent  to  the  Dog  struct. 


Add  a  button  that  makes  some  copies  of  Dogs  and  Canines 

Here’s  the  code: 


Canine  spot  =  new  Canine ("Spot",  "pug"); 

Canine  bob  =  spot; 

bob. Name  =  "Spike"; 

bob. Breed  =  "beagle"; 

spot .Speak ( ) ; 


Dog  jake  =  new  Dog("Jake",  "poodle"); 

Dog  betty  =  jake; 
betty.Name  =  "Betty"; 
betty. Breed  =  "pit  bull"; 

j ake. Speak () ;  _ 

Before  you  press  that  button... 

Write  down  the  what  you  think  w  ill  be  written  to  the  console  w  hen  you  run  this  code: 


en  your  pencil 


you  are  here  ► 
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stack  versus  heap 


What  did  you  think  would  get  written  to  the  console? 

My.  name  is  Spike  a wd  I'm.  a  beagle, . 

My  name  is  Jake  and J  m. a  poodle. . 


Here's  what  happened... 

The  bob  and  spot  references  both  point  to  the  same  object,  so 
both  changed  the  same  fields  and  accessed  the  same  Speak  ( ) 
method.  But  structs  don’t  work  that  way.  When  you  created 
betty,  you  made  a  fresh  copy  of  the  data  in  jake.  The  two 
structs  are  completely  independent  of  each  other. 


A  new  Canine  objett  was 
treated  and  the  spot 
reference  points  to  it 


Canine  spot  =  new  Canine ("Spot", 
Canine  bob  =  spot; 
bob. Name  =  "Spike"; 
bob. Breed  =  "beagle"; 


"pug");@ 

The  new  reference  variable  bob  was 
treated,  but  no  new  object  was  added 
to  the  heap— the  bob  variable  points  to 
the  same  objett  as  spot. 


Z 


BOB 


'*e  0b^C 


spot . Speak () 


Sinte  spot  and  bob  both  point  to  the  same  objett 
spotSpeakO  and  bobSpeakO  both  tall  the  same 
method,  and  both  of  them  produce  the  same  output 
with  "Spike"  and  "beadle". 


Dog  jake  =  new  Dog ("Jake", 
Dog  betty  =  jake;  © 
betty. Name  =  "Betty"; 
betty. Breed  =  "pit  bull"; 
jake. Speak () 

When  you  set  one  struct 
ecjual  to  another,  you  Ye 
creating  a  fresh  COPY  of 
the  data  inside  the  struct. 
That’s  because  struct  is  a 

VALUE  TYPE. 
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‘'poodle")  ,-(4) 

When  you  create  a  new  struct, 
it  looks  really  similar  to  Creating 
an  objett— you've  got  a  variable 
that  you  tan  use  to  access  its 
-fields  and  methods 


N 

Jake  \ 


Here's  the  big  difference  When 
you  added  the  betty  variable,  (s)/" 
you  treated  a  whole  new  struct  /  J 
even  though  you  didn’t  use  the  P°°^*e  j 

new  keyword  's — 

betty 


X'  Jake  X 

I  I 

1  poodle  , 

\ 

x - 


jake 


.  \ 
/  Jake  ' 


1  poodle  } 

K..y 

jake 


Since  you  treated  a  fresh 
dopy  of  the  data,  jake 
was  unaffected  when  you 
Changed  betty’s  fields. 


© 


«>/ 


Betty  \ 


i  pit  bull  j 

Y-"'' 

betty 


{  Jake  ' 
l  poodle  } 

V  J 


jake 


the  death  of  an  object 


The  stack  vs.  the  heap:  wore  on  memory 

It's  easy  to  understand  how  a  struct  differs  from  an  object  you  can  make  a  fresh 
copy  of  a  struct  just  using  equals,  which  you  can’t  do  with  an  object.  Hut  what’s  really 
going  on  behind  the  scenes?  The  reason  structs  act  like  other  value  types  is  that 
value  types  don’t  live  on  the  heap.  The  .NET  GLR  divides  your  data  into  two 
places  in  memory.  You  already  know  that  objects  live  ou  the  heap.  It  also  keeps  another 
part  of  memory  called  the  stack  to  store  all  of  the  local  variables  you  declare  in  your 
methods,  and  the  parameters  that  you  pass  into  those  methods.  You  can  think  of  the 
stack  as  a  bunch  of  slots  that  you  can  stick  values  in.  When  a  method  gets  called,  the 
GLR  adds  more  slots  to  the  top  of  the  stack.  When  it  returns,  its  slots  are  removed. 


Behind 
the  Scenes 

Remember,  when  your 
program's  running,  the  CL R 
■s  adtively  managing  memory, 
dealing  with  the  heap  and 
dolledtmg  garbage 


Even  though  you  dan 
set  an  objedt  variable 
egual  to  a  strudt, 
strudts  and  objedts 
are  different- 


The  Code 

Here’s  code  that  you  might 
see  in  a  program. 


nere  s  what  the  stat 
looks  like  after  thes 
two  lines  of  Code  rut 


Canine  spot  -  new  Canine ("Spot",  "pug") ; 
Dog  jake  =  new  Dog ("Jake",  "poodle"); 


The  Stack 


This  is  where  structs  and  local 
variables  hang  out. 


Canine  spot  =  new  Canine ("Spot",  "pug"); 
Dog  jake  =  new  Dog("Jake",  "poodle"); 

Dog  betty  =  jake; 

When  you  dreate  a  new  strudt— or  any  other  value 
tyye  variable — a  new  'slot  gets  added  onto  the 
stadk  That  slot  «  a  doyy  of  the  value  in  your  type- 


Canine  spot  =  new  Canine ("Spot",  "pug");  ^ 

Dog  jake  =  new  Dog(”Jake",  "poodle"); 

Dog  betty  =  jake;  /l 

SpeakThreeTimes (jake) ; 

public  SpeakThreeTimes  (Dog  dog)  {  tall  a 

method)  the  CLR 

for  (i  =  0;  i  <  5;  i++)  yuts  its  lodal 

dog .  Speak  ( )  ;  variables  on  the 

top  of  the  stadk 
It  takes  them  off 
when  it’s  done 
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don’t  box  me  in 


Yov  can  also  use  the  "is” 
keyword  to  see  i-f  an 
object  is  a  struct,  or 
any  other  value  type, 
that’s  been  boxed  and 
put  on  the  heap 


Wait  a  minute.  Didn't  you  just  say  that  you  can  set 
an  object  variable  equal  to  a  struct?  If  an  object's  on 
the  heap,  and  a  struct  is  on  the  stack,  what  happens? 


When  you  set  an  object  equal  to  a  value  type,  it  gets  boxed. 

There  are  some  times  that  you  need  to  be  able  to  write  a  method  that  can  take 
either  a  value  type  or  a  reference  type — perhaps  a  method  that  can  work  with 
either  a  Dog  struct  or  a  Canine  object.  If  you  find  yourself  in  that  situation, 
you  ran  use  the  object  keyword: 

public  WalkDogOrCanine (object  anything)  {  ...  } 

If  you  send  this  method  a  struct,  the  struct  gets  boxed  into  a  special  object 
“wrapper”  that  allows  it  to  live  on  die  heap.  While  the  wrapper's  on  the  heap,  you 
can’t  do  much  with  the  struct  You  have  to  “unwrap”  the  struct  to  work  with  it. 
Luckily,  all  of  this  happens  automatically  when  you  set  an  object  equal  to  a  value 
type,  or  pass  a  value  type  into  a  method  that  expects  an  object. 


Here’s  what  the  stark  and  heap  look  like  after  you  create  an  object 
variable  and  set  it  equal  to  a  Dog  struct. 

Dog  sid  =  new  Dog("Sid",  "husky"); 


If  you  want  to  unbox  the  object,  all  you  need  to  do  is  cast  it  to  the  right  type,  and 
it  gets  unboxed  automatically.  I  bis  is  where  the  is  keyword  comes  in  handy. 


if  (obj  is  Dog) 


Dog  happy  =  (Dog)  obj; 

A-fter  this  line 
runs,  yov've  got 
a  third  Copy  ot 
the  da^in.a 
w*struct  called 
happy,  which  yb 
its  own  slot  on 
the  stack. 


rue 


7*  boxed,  they  don't  live 
on  the  heap  -n 


OBJ 


Sid 


N  I 

\  I 


l \  husky 

■  '  41  .  f 

I  .f  I 


I  I 


Dog  sid  (boxed) 
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Poo)  Puzz]e 

Your  job  is  to  take  snippets  from  the 
pool  and  place  them  into  the  blank 
lines  in  the  code.  You  may  use 
the  same  snippet  more  than  once, 
and  you  won't  need  to  use  all  the 
snippets.  Your  goal  is  to  make 
the  code  write  this  output  to  the 
console  when  a  new  instance  of  the 
Faucet  class  is  created: 


public  class  Faucet  ( 
public  Faucet ()  { 

Table  wine  =  new  Table ( ) ; 
Hinge  book  =  new  Hinge (); 
wine. SetA (book) ; 
book. SetB (wine)  ; 
wine. Lamp (10) ; 

book . Garden . Lamp ( "back  in" > ; 
book. Bulb  *=  2; 
wine. Lamp ("minutes") ; 
wine . Lamp (book ) ; 

) 

) 


Output  when  you  create  a 
new  Faucet  object: 


back  in  20  minutes 


5*? 


Here's  ti* 


public  _  Table  ( 

public  string  Stairs; 
public  Hinge  Floor; 
public  void  Set (Hinge  b)  { 

Floor  =  b; 

) 

public  void  Lamp (object  oil)  { 

if  (oil  _  int) 

_ .Bulb  =  (int) oil; 

else  if  (oil  _  string) 

Stairs  =  (string) oil; 

else  if  (oil  _  Hinge)  { 

_  vine  =  oil _ ; 

Console . Wr i teLine (vine . Table ( ) 

+  "  "  +  _ .Bulb  +  "  "  +  Stairs); 

) 

) 

) 

public  _  Hinge  ( 

public  int  Bulb; 
public  Table  Garden; 
public  void  Set (Table  a)  { 

Garden  =  a; 

} 

public  string  Tablet)  ( 

return  _ .Stairs; 

) 

Bonus  points:  Circle  the  lines 
where  boxing  happens. 


Note:  each 
thing  from 
the  pool  can 
be  used  more 
than  once. 


-►  Answers  on  page  652. 
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structs  are  safe 


o 

Okay,  back  up  a  minute.  Why  do  I 
care  about  the  stack? 

Because  understanding  the  difference 
between  the  stack  and  the  heap  helps  you 
keep  your  reference  types  and  value  types 
straight  It's  easy  to  forget  that  structs  and 
objects  work  very  differently— when  you  use 
the  equals  sign  with  both  of  them,  they  look 
really  similar.  Having  some  idea  of  how  NET 
and  the  CLR  handle  things  under  the  hood 
helps  you  understand  why  reference  and 
value  types  are  different. 


And  boxing?  Why  is  that  important 


to  me? 


Because  you  need  to  know  when 
things  end  up  on  the  stack,  and  you  need 
to  know  when  data’s  being  copied  back  and 
forth.  Boxing  takes  extra  memory  and  more 
time  When  you're  only  doing  it  a  few  times 
(or  a  few  hundred  times)  in  your  program, 
then  you  won’t  notice  the  difference  But  let’s 
say  you're  writing  a  program  that  does  the 
same  thing  over  and  over  again,  millions  of 
times  a  second.  That's  not  too  far-fetched, 
since  that’s  exactly  what  your  beehive 
simulator  did.  If  you  find  that  your  program's 
taking  up  more  and  more  memory,  or  going 
slower  and  slower,  then  it’s  possible  that  you 
can  make  it  more  efficient  by  avoiding  boxing 
in  the  part  of  the  program  that  repeats. 


o 

I  get  how  you  get  a  fresh  copy  of  a 
struct  when  you  set  one  struct  variable 
equal  to  another  one.  But  why  is  that 
useful  to  me? 


tire  re  i  are  no 

Dumb  Questions 

One  place  that's  really  helpful  is  with 
encapsulation  Take  a  look  at  this  familiar 
field  from  a  class  that  knows  its  location: 

private  Point  location; 
public  Point  Location  { 
get  {  return  location;  ) 

} 

If  Point  were  a  class,  then  this  would  be 
terrible  encapsulation  It  wouldn't  matter  that 
location  is  private,  because  you  made 
a  public  read-only  property  that  returns  a 
reference  to  it,  so  any  other  object  would  be 
able  to  access  it. 

Lucky  for  us,  Point  is  actually  a  struct. 
And  that  means  that  the  public  Location 
property  returns  a  fresh  copy  of  the  point. 
The  object  that  uses  it  can  do  whatever  it 
wants  to  that  copy— none  of  those  changes 
will  make  it  to  the  private  location  field. 

o 

If  Point  is  a  struct,  does  that  mean 
there  are  other  structs  that  I’ve  been 
working  with  all  along? 

I  Yes!  One  struct  that's  really  useful 
and  very  common  when  you're  working  with 
graphics  and  forms  is  Rectangle.  It’s 
got  some  very  useful  methods  that  come  in 
really  handy  when  you  need  to  figure  out 
boundaries  and  check  whether  points  are 
inside  or  outside  of  the  rectangle.  All  you 
need  to  do  is  set  its  location  and  size,  and 
it'll  automatically  compute  its  top,  bottom, 
left,  right,  width,  and  height. 

Another  useful  struct  that  you'll  run  into  is 


action— you  used  it  when  you  were 
determining  the  size  of  a  string  using  the 
Measurestring  ( )  method  It’s  a 
struct,  too. 

O:  How  do  I  know  whether  to  use  a 
struct  or  a  class? 

Most  of  the  time,  programmers  use 
classes.  Structs  have  a  lot  of  limitations  that 
can  really  make  it  hard  to  work  with  them  for 
large  jobs  They  don't  support  inheritance, 
abstraction,  or  polymorphism,  and  you 
already  know  how  important  those  things  are 
for  building  programs  easily. 

Where  structs  come  in  really  handy  is  if  you 
have  a  small,  limited  type  of  data  that  you 
need  to  work  with  repeatedly  Rectangles 
and  points  are  good  examples— there's  not 
much  you'll  do  with  them,  but  you'll  use 
them  over  and  over  again.  Structs  tend  to  be 
relatively  small  and  limited  in  scope.  If  you 
find  that  you  have  a  small  chunk  of  a  few 
different  kinds  of  data  that  you  want  to  store 
in  a  field  in  a  class  or  pass  to  a  method  as  a 
parameter,  that’s  probably  a  good  candidate 
for  a  struct. 

A  struct  can  be  very 
valuable  when  you 
want  to  add  good 
encapsulation  to 
your  class,  because  a 
read-only  property 
tbat  returns  a  struct 
always  makes  a 
fresb  copy  of  it. 

- Pop  <\uiz,  hotshot/ 

Answer's  on  pjge  t>^i, 
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Captain  Amazing...  not  so  much 


With  all  this  talk  of  boxing,  you  should  have  a  pretty  good 
idea  of  what  was  going  on  with  the  less-powerful,  more- 
tired  Captain  Amazing.  In  fact,  it  wasn’t  Captain  Amazing 
at  all,  but  a  boxed  struct: 


t  struct 


VS. 


Structs  can't  inherit  from 
classes  or  implement  interfaces 

No  wonder  the  Captain’s  superpowers 
seemed  a  little  weak!  He  didn’t  get  any 
inherited  behavior. 


That's  one  big 
advantage  of  steucb 
(and  other  value 
types)— you  can  easily 
make  dopies  of  them. 


You  can’t  create  a  fresh  copy  of 
an  object 

When  you  set  one  object  variable  equal 
to  another,  you’re  copying  a  reference  to 
the  same  variable. 


Structs  can  only  live  on  the  heap 
when  they're  boxed 

The  struct  couldn’t  get  onto  the  heap 
without  being  boxed  up. 


You  can  use  the  “as"  keyword  with 
an  object 

(  )bjects  allow  for  polymorphism  by 
allowing  an  object  to  function  as  any  of 
the  objects  it  inherits  from. 


ESSENCE 


Back  at  the  Lab  I 


I  THINK  I VE  FOUND  A  WAY  TO  GIVE  Mb 
POWERS  TO  A  NORMAL  CITIZEN! 
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extend  this 


Extension  methods  add  new 
behavior  to  EXISTING-  classes 

Sometimes  you  need  to  extend  a  class  that  you  can’t  inherit  from,  like  a  sealed  class  (a  lot  of  the  .NET  classes 
are  sealed,  so  you  can’t  inherit  from  them).  And  C#  gives  you  a  powerful  tool  for  that:  extension  methods. 
When  you  add  a  class  with  extension  methods  to  your  project,  it  adds  new  methods  to  classes  that  already 
exist.  All  you  have  to  do  is  create  a  static  class,  and  add  a  static  method  that  accepts  an  instance  of  the  class  as  its 
first  parameter  using  the  this  keyword. 


So  let's  say  you’ve  got  an  OrdinaryHuman  class: 


public  sealed  class  OrdinaryHuman  { 
private  int  age; 
int  weight; 


The  OrdinaryHuman  class  is 
sealed,  so  it  can’t  be  subclassed 
But  what  i-f  we  want  to  add  a 
method  to  it? 


public  void  GoToWorkO  {  //  code  to  go  to  work  ) 
public  void  PayBillsO  {  //  code  to  pay  bills  } 


public  OrdinaryHuman  (int  weight)  {  You  use  an  extension  method 

this. weight  =  weight;  by  specifying  the  -first 

}  Parameter  using  the  "this" 

keyword.  » 

public  void  GoToWorkO  (  II  code  to  go  to  work  1  vt, 

public  void  PayBillsO  {  //  code  to  pay  bills  }  Since  we  want  to  extend  the 

1  0£2r>. £USS'  **  wake  *Ke  Gwfc 

The  SuperSolierSerum  method  adds  an  extension  method  to  OrdinaryHuman:  j  t  ^is  OrdinaryHuman 

public  static  class  SuperSoldierSerum  ( 

public  static  string  BreakWalls (this  OrdinaryHuman  h,  double  wallDensity)  { 
return  ("I  broke  through  a  wall  of  ”  +  wallDensity  +  "  density."); 

Extension  methods  are  always 
static  methods,  and  they  have 
to  live  in  static  classes. 


As  soon  as  the  SuperSoldierSerum  class  is  added  to  the  project,  OrdinaryHuman 
gets  a  BreakWalls  method.  So  now  a  form  can  use  it:  ■T 

private  void  buttonl_Click (object  sender,  EventArgs  e)  ( 
OrdinaryHuman  Steve  =  new  OrdinaryHuman (185) ; 

Console. WriteLine (steve. BreakWalls  (89.2) ) ; 


When  the  •form  Creates 
an  instance  of  the 
OrdinaryHuman  class,  it 
can  access  the  BreakWallsO 
method  directly— as  long 
as  it  has  access  to  the 
SuperSoldierSerum  class. 


_  (tjjbarpen  your  pencil _ 

SollltiOn  ^his  met^oc*  's  suPPosed  to  kill  a  Clone  object,  but  it  doesn't  work.  Why  not? 

private  void  SetCloneToNull (Clone  clone)  { 

So  the  clone  parameter  clone  =  null; 

is  just  on  the  stack,  so  , 

setting  it  to  null  doesn  t  do  ^ 

anything  to  the  heap  All  this  method  does  is  set  its  own  parameter  to  null,  but  that  parameter  s  just  a 

re-ferenCe  to  a  Clone.  It’s  like  sticking  a  label  on  an  object  and  peeling  it  off-  again 
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tfierejOre  no 

Durnb  Questions 


Qj  Tell  me  again  why  I  wouldn't  add  the  new  methods  I 
need  directly  to  my  class  code,  instead  of  using  extensions? 

You  could  do  that,  and  you  probably  should  if  you're  just 
talking  about  adding  a  method  to  one  class  Extension  methods 
should  be  used  pretty  sparingly,  and  only  in  cases  where  you 
absolutely  can’t  change  the  class  you're  working  with  for  some 
reason  (like  it's  part  of  the  NET  Framework  or  another  third  party). 
Where  extension  methods  really  become  powerful  is  when  you 
need  to  extend  the  behavior  of  something  you  wouldn't  normally 
have  access  to  like  a  type  or  an  object  that  comes  for  free  with 
the  NET  framework  or  another  library. 

cv 

VQ<;  Why  use  extension  methods  at  all?  Why  not  just  extend 
the  class  with  inheritance? 


Sure,  But  then  you'd  need  to  use  your  custom  objects, 
and  any  existing  code  that  used  the  onginai,  non-extended 
objects  would  have  to  change.  With  extension  methods,  you 
can  change  the  behavior  of  whole  groups  of  objects,  and  even 
add  functionality  to  some  of  the  most  basic  classes  in  the  NET 
Framework. 

Extending  a  class  gives  you  new  behavior,  but  requires  that  you 
use  the  new  subclass  if  you  want  to  use  that  new  behavior. 

O I  Does  my  extension  method  affect  all  instances  of  a 
class,  or  just  a  certain  instance  of  the  class? 

j\'.  It  will  affect  all  instances  of  a  class  that  you  extend  In  fact, 
once  you’ve  created  an  extension  method,  the  new  method  will 
show  up  in  your  IDE  alongside  of  the  extended  class  s  normal 
methods 


Thai's  anoiher  ihinj 
you  just  tan’i  do  wiih 
inheviiante— iheve  s  no 
way  io  inhev-ii  -from  dn 
in  Icrfatc 


Oh,  I  get  it!  So  you'd  use  extension  methods 
to  add  new  behavior  to  one  of  the  built-in 
.NET  Framework  classes,  right? 


Exactly!  There  are  some  classes  that  you  can’t  inherit  from. 

Pop  open  any  project,  add  a  class,  and  try  typing  this: 
public  class  x  :  string  {  } 

Try  to  compile  your  code — the  IDE  will  give  you  an  error.  The  reason  is  that  some  .NET 
classes  are  sealed,  which  means  that  you  can’t  inherit  from  them.  (You  can  do  this  with 
your  own  classes,  too! Just  add  the  sealed  keyword  to  your  class  after  the  public  access 
modifier,  and  no  other  class  will  he  allowed  to  inherit  from  it.)  Extension  methods  give 
you  a  way  to  extend  it,  even  if  you  can’t  inherit  from  it. 

But  that’s  not  all  you  can  do  with  extension  methods.  In  addition  to  extending  classes, 
you  can  also  extend  interfaces.  All  you  have  to  do  is  use  an  interface  name  in  place  of 
the  class,  after  the  this  keyword  in  the  extension  method's  first  parameter.  W  hen  you 
do,  the  extension  method  is  added  to  every  class  that  implements  that  interface. 
Remember  that  LI NQ.  code  you  added  to  your  simulator  in  chapter  12?  LlNQ,was  built 
entirely  with  extension  methods,  extending  the  I  Enumerable  class.  (You'll  learn  a  lot 
more  about  LINQJn  Chapter  15.) 
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Extending  a  fundamental  type:  string 

You  don’t  often  get  to  change  the  behavior  of  a  language’s 
most  fundamental  types,  like  strings.  But  with  extension 
methods,  you  can  do  just  that! 


Put  all  of  your  extension  methods  in  a  separate  namespace 

It's  a  good  idea  to  keep  all  of  your  extensions  in  a  different  namespace  than  the  rest  of 
your  code.  That  way,  you  won’t  have  trouble  finding  them  for  use  in  other  programs.  Set 
up  a  static  class  for  your  method  to  live  in.  too.  |/Slri^  a  ie^Sraie  namespace  is  a  good 

„  ,  <£- - organizational  fool 

namespace  Emergency  {  ^  j 

public  static  class  HumanExtensions  {-r,  .  , 

-  i  he  Class  your  extension  method  is 

^  defined  in  must  be  static. 

Q)  Create  the  static  extension  method,  and  defines  its  first  parameter  as 
this  and  then  the  type  you're  extending. 

The  two  main  things  you  need  to  know  when  you  declare  an  extension  method  is  that  the 

method  needs  to  be  static  and  have  the  class  it’s  extending  as  its  first  parameter.  this  string"  jays  *eVe 

- - - extending  the  str.no  A* 

public  static  bool  IsDistressCall  (this  string  s)  {  “  ®ss' 

^  *  The  extension  method  must 

Put  the  code  to  evaluate  the  string  in  the  method.  be  static,  too 

public  static  class  HumanExtensions  { 

public  static  bool  IsDistressCall (this  string  s) { 
if  (s .Contains ("Help !") ) 
return  true; 

else  ^ —  This  checks  the  string  tor  a  Certain  value  something 

j _ r*  * i  _ l .  r  .  ii  •  e  ii  i  .  .  J 


return  false; 


} 


definitely  not  in  the  default  string  class. 


} 


Create  a  form  and  add  a  string. 

Add  using  Emergency;  to  your  code.  Now.  when  you  use  a  string,  you  get  the  extension  methods 
for  free.  You  can  see  this  for  yourself  by  typing  the  name  of  a  string  variable  and  a  period: 

string  messagel; 

messagel  =  "An  army  of  clones  is  wreaking  havoc  at  the  factory.  Help! 


messagel . 


7 


As  soon  as  you  type 
the  dot,  The  IDE 

pops  up  a  helper 
window  with  all  of 
string’s  methods ...  _ 
including  you r 
extension  method- 


^  GetTypeCode 
U  IndexOf 
♦  IndexOf  Any 
^  Insert 


IsDistressCall 


♦  IsNormalized 

♦  LastlndexOf 

♦  LastlndexOf  Any 
Length 

♦  Normalize 
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the  |ntell.Sexse  wmdow- 

This  toy  example  just  shows  you  the 
syntax  of  extension  methods.  To  get 
a  real  sense  of  how  useful  they  are, 
just  wait  until  the  next  chapter.  It’s 
all  about  LINQ,  which  is  implemented 
entirely  with  extension  methods. 


the  death  of  an  object 


Extension  Magnets 

Arrange  the  magnets  to  produce  this  output: 

a  buck  begets  more  bucks 


□ 
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the  captain’s  alive! 


Extension  Magnets 

Your  job  was  to  arrange  the  magnets  to  produce  this  output: 
a  buck  begets  more  bucks 


The  Upside  namespate 
has  -the  extensions  The 
Sideways  name  spate  has 
the  entry  point 


namespace  Upside  {  □ 


The  Margin  tlass  extends  string  by  adding 
a  method  tailed  SendltO  that  \ust  writes 
the  string  to  the  tonsole,  and  it  extends  int 
by  adding  a  method  tailed  ToPriteO  that 
returns  “a  butk"  if  the  int's  egual  to  I,  or 
butks"  if  it’s  not 


more 


public  static  class  Margin  {  j 


The  entry  point  method 
uses  the  extensions  that 


|  public  static  void  Sendlt 

(this  string  s)  {I 

tlass 

|  Console .Write (s)  ;  | 

uJ  _ 

namespace  Sideways  { 
using  Upside; 

public  static  string  ToPrice  (this  int  n)  {  | 

if  (n  ==  1) 

return  "a  buck 


else 


I 


public  static  void  Main  { 


return  "  more  bucks"; 


int  i  =  1; 


1 


public  static  string  Green 

(this  bool  b)  { 

1 

s.  Sendlt  () 

if  (b  =  true) 
return  "be"; 


else 


return  "gets 


The  ^reen  method  extends  a 

D  bool-it  returns  the  string  "be" 
|  it  the  bool  is  true,  and  "gets" 
J  'f  it's  false 


bool  b  =  true 


Here's  where  the  Margin  tlass  extends 
bool  by  adding  a  £jreenO  method  to  it 
If  the  bool  is  true,  {free*  returns  "be”, 
otherwise  it  returns  “gets 


1  b . Green ( ) ; 

[ 

i.ToPrice()  1  .SendltO; 

3 
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WE’VE  REBUILT  THE  SlfERHERO  CLASS,  BUT 
HOw  DO  WE  BRING  BACK  THE  CAPTAIN? 


^UNIVERSE® 


Death  was  not  the  end! 

By  Bucky  Barnes 

I  M\  ERSE  STAFF  W  RITER 

OBJECTVILLE 

■*»"«  «-».  stunning 

month,  CapL^aXgSoCZ  "'"P1* to  °b>ctvillo.  La* 

left  where  liis  body  should  have  been  AinK  ''r'V  °n,y  3  stranKe  note 
Amazing’s  object  DNA-  all  his  last  fi,  |  |  '  ,  °  "C  n°tC  rcvealed  Capiain 

binary  format.  '  s  and  vaJuc*>  captured  faithfully  in 

lixlay,  that  data  has  sprune  to  lilr  ri.,.  r  •  .  . 

own  brilliant  note.  When  ;fskcd  how  h  '  ‘P  a  deserialized  fom  his 
m<Tcl>  drugged  and  f  3  »*">  Captain 

•  -see  AMAZING  on  A-5 


Captain  Amazing 
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puzzle  solution 


poo]  Puzz] c  §o]ufion 


TVie  Li^O  method  sets  **"■» 

sbrirp  3^  mb-  I*  'V’u 

•  i  it  sets  the  Bulb  t>elo 
3*  int,  then  it  i  i 

whatever  object  Hinge  fomb  to 


an 

m 


Output  when  you  create  a 
new  Faucet  object: 

back  in  20  minutes 

public  class  Faucet  { 
public  Faucet ()  { 

Table  wine  =  new  Table ( ) , 
Hinge  book  =  new  Hinge () 
wine .Set (book) ; 
book. Set (wine) ; 


0,  wine . Lamp (10) ;  ZD 
C?  book. Garden. Lamp ("back  in"TT" 
book. Bulb  *=  2; 

(wine . Lamp ( "minutes^J 
wine. Lamp (book) ; 

) 

)  Here's  *Ky  T^l«  bas  to  be  a  struct  If  ii 

wene  a  class,  then  wine  would  point  to  the 
**•*  object  as  book  garden,  which  would 
Uue  this  to  overwrite  tbe  “back  in"  string 

Bonus  question:  Circle  the 
lines  where  boxing  happens. 

Since  the  LamfO  method  takes  an  object 
parameter,  boning  automatically  happens 
when  it’s  passed  an  int  or  a  string- 


public  Struct  Table  { 

public  string  Stairs; 
public  Hinge  Floor; 
public  void  Set (Hinge  b)  { 

Floor  =  b; 

) 

public  void  Lamp (object  oil)  { 

if  (oil  Js. int)  1^  you  pass  a 

Floor . Bulb  =  (int)oil;  string  to  Lamp, 

it  sets  the  Stairs 

else  if  (oil_js_  string)  y  field  to  whatever 

Stairs  =  (string)oil;  '*  lh  that  string. 

else  if  (oil  is  Hinge)  ( 

Hinge  vine  =  oil  _gs_  Hinoe ; 

Console. WriteLine (vine. Table  ( ) 

+  "  "  +  Floor. Bulb  +  "  "  +  Stairs); 


) 


Remember,  the  as 
keyword  only  works  with 
classes,  not  strue-U 


J 


public  closs  Hinge  ( 
public  int  Bulb; 


Both  Hinge  and  Table 
have  a  SetO  method 
f  Hinge’s  SetO  sets 

public  Table  Garden;  ^  its  Tab|e  fcy  ta||ed 

public  void  Set  (Table  a)  (  garden,  and  Tables 

SetO  method  sets 

Garden  =  a?  its  Hmge  field  called 

)  Floor. 

public  string  Tablet)  ( 
return  Garden .Stairs; 

) 
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Get  control  of  your  data 


So  if  you  take  the  first  word  from  this 
article,  and  the  second  word  in  that  list,  and 
add  it  to  the  fifth  word  over  here...  you  get 
secret  messages  from  the  government! 


It’s  a  data-driven  world...  you  better  know  how  to  live  in  it. 

Gone  are  the  days  when  you  could  program  for  days,  even  weeks,  without  dealing  with 
loads  of  data  But  today,  everything  is  about  data  In  fact,  you’ll  often  have  to  work 
with  data  from  more  than  one  place ...  and  in  more  than  one  format.  Databases,  XML, 
collections  from  other  programs ...  it's  all  part  of  the  job  of  a  good  C#  programmer  And 
that’s  where  LINQ  comes  in.  LINQ  not  only  lets  you  query  data  in  a  simple,  intuitive  way, 
but  it  lets  you  group  data,  and  merge  data  from  different  data  sources 


this  is  a  new  chapter  653 


devil's  in  the  details 


Am  easy  project... 


Objectville  Paper  Company  wants  to  do  a  cross-promotion  with 
Starbuzz  Coffee.  Starbuzz  has  a  frequent  customer  program  where 
they  know  who  buys  which  drink  and  how  often  they  buy  it.  Objectville 
Paper  wants  to  figure  out  which  of  their  customers  are  also 
Starbuzz  regulars  and  send  them  a  free  mug  and  a  coupon  for 
their  favorite  coffee  drink...  and  it’s  up  to  you  to  combine  the  data  and 
generate  the  list  of  customers  to  send  mugs  and  coupons  to. 


All  of  Objectville  Paper’s 
customers  who  are  Starbuzz 
regulars  get  a  free  mug.  Just  tell  us 
who  the  mugs  need  to  go  to  and  what 
their  favorite  drinks  are,  okay? 


C 


o 


o 
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...but  the  data's  all  over  the  place 

Starbuzz  keeps  all  their  data  in  rlasses,  grouped  together  in  a  big  List. 
Hut  the  Objectville  data  is  in  a  database  (front  way  back  in  Chapter 
1).  We  want  to  find  any  Starbuzz  customers  who  spent  more  than  $90, 
match  them  to  the  Objectville  Paper  contact  list,  and  make  a  final  list 
of  people:  we  w  ant  each  person’s  name,  the  company  they 
work  for,  and  their  favorite  Starbuzz.  drink. 


The  Starbuzz  data’s  in  a  Listo 

The  Starbuzz  people  provided  a  program  that 
connects  to  their  website  and  pulls  all  the  data 
into  a  List  of  StarbuzzData  class. 


c1 

Here's  the  class 

and  enum  &»"* 

S-tarUzA*  tode 


l  . 

Vow  need  to  jet  the  list  of 
Starbuzz.  data,  and  find 

the  Customers  that  match 
Objectville  Customers 


public  class  StarbuzzData 
{ 

public  string  Name  {  get;  set;  ( 
public  Drink  FavoriteDrink  )  get;  set;  ) 
public  int  MoneySpent  (  get;  set;  } 
public  int  Visits  {  get;  set;  } 

1 


public  enum  Drink  ( 
BoringCof fee, 
ChocoRockoLatte, 
TripleEspresso , 
ZestyLemonChai , 
DoubleCappuccino, 
HalfCaf Americano, 
ChocoMacchiato, 
BananaSplitlnACup, 

1 


You’ve  already  got  the  customer  data 

You  built  the  Objectv  ille  Paper  Company  contact  list 
back  in  Chapter  1  it’s  got  part  of  the  data  you  need. 


All  of  -the  Objectville  Customer 
data  is  in  a  database 


How  would  you  combine  the  data 
from  Starbuzz  and  Objectville  paper 
to  get  a  complete  contact  list? 


you  are  here  ► 
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LINQ  to  the  rescue 


UNQ  can  pull  data  from  multiple  sources 


You  used  UNO  in  the  Hue  Simulator  to  track  what  groups  of  Bees 
were  doing.  You  took  advantage  of  the  power  of  LINQ  there  to  write 
simple  queries  to  pull  data  out  of  a  collection.  LINQ  can  work  with 
the  Starbuzz  data  just  like  it  worked  with  the  bees,  helping  you  use 
queries  to  pull  out  customer  data.  As  long  as  a  collection  implements 
the  IEnumerable  interface,  you  can  use  1 .INQqueries  with  it. 


But  LINO  also  lets  you  work  with  more  than  just  collections.  You  can 
use  the  same  queries  to  pull  data  from  a  database,  or  even  an  XML 
document.  So  once  we  get  collections  under  control,  we  can  use 
LINQon  the  Objectville  database. 


In  the  simulator,  the  bees 
were  in  a  Collection 


Here  was  the  *uery  we  used  in 
the  bee  simulator  to  *roup  and 
order  bees  by  their  state 


var  beeGroups  = 

from  bee  in  world. Bees 
group  bee  by  bee . CurrentState 
into  beeGroup 
orderby  beeGroup. Key 
select  beeGroup; 


t 

We  need  a  similar  *uery  to  pull  data 
-from  the  Starbuiz.  Customer  data, 
which  is  also  in  a  Collection- 


n 


currentState  =  Gather  ngNectaF"^ 


currentState  =  MakingHoney 


-  FlyingToFlower 


=  GatheringNectar 


<bee  »d=  98  r  currentState3  MakingHoney  r> 
<bee  id3"  12"  currentState-'FlyingToFlower”  /> 
<bee  id=”1982'  currentState="GatheringNectar'  /> 


XML 


- 


LINQ_ works  with  pretty  much  every  kind  of  data  source  you  could 
use  in  .NET.  Your  code  needs  a  using  System.  Linq;  at  the  top 
of  your  file,  but  that’s  it.  Even  lx- iter,  the  IDE  automatically  puts  a 
reference  to  LINQ  in  die  header  of  any  code  files  that  are  created  in 
Visual  Studio  2008.  So  if  you’re  using  Visual  Studio  2008  or  later,  just 
start  coding,  and  LINQ  is  available  to  you. 


The  mce  thin*  about  UN<8 

that  the  same  «\uery  works  on  a 

database  or  /ML  do6ument,  ot 
bees  or  Customers  or  anythin*  else- 
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.NET  collections  are  already  set  up  for  UNQ 

All  of  the  collection  types  in  .NET  implement  the  IEnumerable  interface. 
Type  System.  Collections .  Generic .  IEnumerable  into  your  IDE 
window,  right-click  on  the  line,  and  select  Go  To  Definition.  You’ll  see  that 
the  IEnumerable  interface  defines  a  GetEnumerator  ( )  method: 


* 


Th«s  T  mea*s  that 
IEnumerable  *ai 
arty  object  or  ty?c 


namespace  System. Collections .Generic  { 

public  interface  IEnumerabl^T^j) :  IEnumerable  { 

//  Summary: 

//  Returns  an  enumerator  that  iterates  through  the  collection 

// 

//  Returns: 

A  System. Collect ions. Generic. IEnumerator<T>  that  can  be 


// 

// 


used  to  iterate  through  the  collection. 


IEnumerator<T>  GetEnumerator () ; 


} 


} 


This  method  requires  collections  to  define  a  way  to  move 
through  the  collection,  one  element  at  a  time.  That's  all 
LINQ  requires  as  a  prerequisite.  If  you  can  move  through  a 
list  of  data,  ilem-by-item,  I.INQcan  query'  the  collection. 


This  is  -the  only  method  in  the  interface  Each 
Collection  implements  this  method  You  Could  Create 
your  own  kind  of  Collection  that  implemented 
IEnumerable  too-  And  if  you  d.d,  you  could  use  UNQ 
with  your  Collection 


LINQ  uses  extension  methods  to  let  you  query;  sort,  and  update  data. 

Check  it  out  for  yourself.  Create  an  int  array  called  linqtest.  put  some 
numbers  in  the  array,  and  then  type  this  line  of  code  (don't  worry;  you’ll  learn 
what  it  does  in  a  minute):  ■" 

var  result  =  from  i  in  linqtest  where  i  <  3  select  i; 

Now  comment  out  the  using  System.  Linq;  line  up  in  the  header  of  the 
file  you’ve  created.  When  you  try'  to  rebuild  the  solution,  you’ll  see  that  this  line 
doesn't  compile  anymore.  The  methods  you’re  calling  when  you  use  LINQ  are 
just  extension  methods  that  are  being  used  to  extend  the  array; 


Now  you  Can  see  why  extension 
methods  were  so  import*,*  i„ 
Chapter  H*...  they  let  NET 
fahd  you)  add  all  kinds  of  cool 
behavior  to  existing  types. 


Behind 
the  Scenes 


you  are  here  ► 
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some  queries  are  simple 


UNQ  wakes  queries  easy 

Here’s  a  simple  example  of  LINQ. syntax.  It  selects  all  the  numbers  in  an 
int  array  that  are  under  37  and  puts  those  numbers  in  ascending  order. 

It  does  that  using  four  clauses  that  tell  it  what  collection  to  query;  what 
criteria  to  use  to  determine  which  members  of  the  collection  to  select,  how 
to  sort  the  results,  and  how  the  results  should  be  returned. 

int[]  values  =  new  int[]  {0,  12,  44,  36,  92,  54,  13,  8} 


foreach (int 

Console . WriteLine ( 


This  assigns  -the  letter  “v”  to  stand  in  -for 
each  of  the  values  array  in  the  query  So  v  is 
^  0>  then  I Z,  then  W,  then  it...  etc 

where  v  <  37 <  v  _ 

This  says,  select  each  v  in  the 

array  that  is  less  than  VI. 

or derby  v  \ 

Then  put  those  values  in  order 
(lowest  to  highest). 

|{  you've  used  S#L-  before,  it  may 
seem  weird  to  put  the  select  at 
the  end,  but  that's  how  things 
.  work  in  L|N<$ 

i)  ;*>/ 


var  result  =  from  v  in  values 


This  L|K($  <\uery  has 
(■our  clauses  the  from 
clause,  a  where  clause,  an 
©rderby  clause,  and  the 
select  clause 


vav- 


Now  you  can  iterate  through  the 
results  array  and  print  out  each 
item  in  the  LlN$  result  — 

^  Output: 

0,  8,  12,  13,  36 


var  is  a  keyword  that  tells  the  Compiler  to 
figure  out  tbe  type  of  a  variable  at  compilation 
time  NET  detects  the  type  from  tbe  type 
of  the  local  variable  that  you're  using  LlNQ  to 
guery  When  you  build  your  solution,  the  Compiler 
will  replace  var  with  the  right  type  for  the  data 
you’re  working  with 

|n  the  example  above,  when  this  line  is  Compiled- 

var  result  =  from  v  in  values 

The  Compiler  replaces  'var''  with  this: 

IEnumerable<int> 


LINQ  is  a  new  feature 
that’s  part  of  C#  3.0  and 
Visual  Studio  2008. 


WtltcH  it.  if  you're  using  an  earlier 
version  of  C#.  take  a  few 
minutes  to  download  and  install  Visual 
C#  2008  Express  Edition.  It’s  free  from 
Microsoft,  and  it  can  be  installed 
alongside  previous  versions. 
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LINQ  is  simple,  but  your  queries  don't  have  to  be 

Jimmy  just  sold  his  start-up  company  to  a  big  investor,  and  wants  to  take  some 
of  his  profits  and  buy  the  most  expensive  issues  of  Captain  Amazing  that  he  can 
find.  But  all  he’s  got  is  data.  How  can  LINQ.  help  him  scour  his  two  collections 
and  figure  out  which  comics  are  the  most  expensive? 


Jimmy  downloaded  a  list  of  Captain  Amazing  issues  from  a  Captain  Amazing  fan  page.  He  put 
them  in  a  Listo  of  Comic  objects  that  have  two  fields,  Name  and  Issue. 


public  class  Comic  ( 

public  string  Name  {  get;  set;  } 
public  int  Issue  (  get;  set;  ) 

) 


Jimmy  used  object  initializers  and  a  collection  initializer  to  build  his  catalog: 


private  static  List<Comic>  BuildCatalog ( )  ( 

List<Comic>  comics  =  new  List<Comic> () ; 

comics. Add (new  Comic ("Johnny  America  vs.  the  Pinko",  6)); 
comics. Add (new  Comic("Rock  and  Roll  (limited  edition)",  19)); 
comics .Add (new  Comic ("Woman' s  Work",  36)); 
comics .Add (new  Comic ("Hippie  Madness  (misprinted)",  57)); 
comics. Add (new  Comic ("Revenge  of  the  New  Wave  Freak  (damaged)", 

comics. Add (new  Comic ("Black  Monday",  74));  ^ - 

comics. Add (new  Comic ("Tribal  Tattoo  Madness",  83)); 


68) ) 


comics. Add (new  Comic ("The  Death  of  an  Object", 
return  comics; 


97)), 


7 


Issue  #7^  Capta  in 

is  called  “Black  Monday" 


Luckily,  there’s  a  thriving  marketplace  for  Captain  Amazing  comics  on  Greg’s  List.  He  knows  that 
issue  #57,  "Hippie  Madness,”  was  misprinted  and  the  almost  all  of  the  run  was  destroyed  by  the 
publisher,  and  he  found  a  rare  copy  recently  sold  on  Greg’s  List  for  813,525.  After  a  few  hours  of 
searching,  Jimmy  was  able  to  build  a  DictionaryO  that  mapped  issue  numbers  to  values. 


private  static  Dictionarycint,  int>  GetPricesO  ( 

Dictionarycint,  int>  values  =  new  Dictionarycint,  int>() 
values. Add (6,  3600); 


values .Add (19, 
values .Add (36, 
values. Add (57, 
values. Add (68, 
values. Add (74, 
values. Add (83, 
values. Add (97, 
return  values; 


Issue  #57  is  worth  /|3,5 Z5. 

RAIN 


Look  closely  at  the  LINQ  query  on  page  658. 
What  do  you  think  Jim  has  to  put  in  his  query 
to  find  the  most  expensive  issues? 


you  are  here  ► 
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it’s  not  sql 


Anatomy  of  a  <fiiery 


It’s  easy  to  mine  Jimmy’s  data  with  one  LIN Q. query.  The  where  clause  tells  LINQ. which 
items  from  the  collection  should  be  included  in  the  results.  But  that  clause  doesn’t  just  have 
to  lx-  a  simple  comparison.  It  can  include  any  valid  C#  statement — like  using  the  values 
dictionary  to  tell  it  to  return  only  comics  worth  more  than  $5U0.  And  the  orderby  clause 
works  the  same  way  we  can  tell  LINQ.  to  order  the  comics  by  their  value. 

The  LlN<$  «\uery  pulls  Comic  objetts 


List<Comic>  comics  =  BuildCatalog () 
Dictionary<int ,  int> 


out  of  the  Com Its  list,  usin^  the 
data  in  the  values  dictionary  to 
detide  which  t omits  to  select 


var  mostExpensive  = 

comics 


values  =  GetPrices() 

Tke  -first  tlause  in  the  <\uery  is  the  from  clause  This  one  tells 
UM?  to  <\uery  the  comics  tollettion,  and  that  the  name 
comic  will  be  used  in  the  «\uery  to  specify  how  to  treat  eath 
individual  piece  of  data  in  the  tollettion. 


You  dan 
thoose  any 
name  you 
want  when 
use  a 

rom  clause 
We  those 

u  .  u 

tomid  . 


from 


comic 


in 


F. 


where  values [comic . Issue]  >  500 
orderby  values [comic . Issue]  descending 

comic  t  name  comic  was  defined  in  the  from 

clause  specif  itally  so  it  Could  be  used  in 


The  where  and  orderby 
clauses  can  include  AKY/  C# 
statement,  so  we  tan  use  the 
values  dictionary  to  select 
only  those  Comics  worth 
more  than  f*5 00  and  we  can 
sort  the  results  so  the  most 
expensive  ones  Come  first- 


the  where  and  order  by  clauses 

foreach  (Comic  comic  in  mostExpensive) 

Console .WriteLine ("{ 0 }  is  worth  {l:c}", 

comic. Name,  values [comic . Issue] ) 


When  you  add  “{he}”  to  the 
WriteLine  output  that  tells  it 
to  print  the  second  parameter 
in  the  local  Currency  format 


The  <\uery  returned  its  results  into  a  Collection  called 
mostExpensive  The  select  tlause  determines  what 
<yjes  into  the  results-sinde  it  selected  comic,  the 


□) 

Show  output  from :  Debug 

-  A 

»»  1 

Hippie  Madness  (misprinted)  is 

worth  $13,525.00 

1 

Johnny  America  vs.  the  Pinko  is 
Woman's  Work  is  worth  $  650. 00 

worth  $3,600.00 

v 

< 

> 

_J 
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I  don't  buy  this.  I  know  SQL  already— isn’t 
writing  a  LINQ  query  just  like  writing  SQL? 


Don't  worry  if  you  ve 
never  used  S$L-— you 
don’t  need  to  know 
anything  about  it  to 
work  with  L-|N<$  But  i-f 
you're  Curious,  check  out 

"Head  First  S$L 


LINQ  may  look  like  SQL,  but  it  doesn’t  work  like  SQL. 

If  you’ve  done  a  lot  of  work  with  SQL,  it  may  he  tempting  to  dismiss 
all  this  LINQ  stuff  as  intuitive  and  obvious — and  you  wouldn’t  be  alone, 
because  a  lot  of  developers  make  that  mistake.  It's  true  that  LINQ  uses 
the  select,  from,  where,  ascending,  and  join  keywords,  which 
are  borrowed  from  SQL.  But  LINQ  is  v  ery  different  from  SQL,  and  if 
you  try  to  think  about  LINQ  the  way  you  think  about  SQL  you’ll  end 
up  with  code  that  doesn’t  do  what  you  expect. 

One  big  difference  between  the  two  is  that  SQL  operates  on  tables, 
which  are  very  different  from  collections.  W  hen  you  execute  a  SQL 
select  against  a  table,  you  can  be  sure  that  the  table  is  not  going  to 
be  updated.  SQL  has  all  sorts  of  built-in  data  security  that  you  can  trust. 
And  SQL  queries  are  set  operations,  which  means  they  don’t  examine 
the  rows  in  the  tabic  in  any  predictable  order.  A  collection,  on  the 
other  hand,  can  store  anything — values,  structs,  objects,  anything  and 
collections  have  a  specific  order.  (A  table’s  rows  aren't  in  any  particular 
order  until  you  make  a  SQL  query  that  orders  them;  items  inside  a 
t  List,  on  the  other  hand,  are  in  order.)  And  LINQ  lets  you  perform  any 
operation  that’s  supported  by  whatever  happens  to  be  in  the  collection — 


Thore  are  a  lot  of  other  / 
differed,  between  LINQ  an(j 
too,  but  you  don't  need 
to  understand  them  in  order 
to  work  with  LINQ  successfully, 
dust  approach  it  with  an  open 
”',r'd,  and  don't  expect  it  to 
*oek  the  way  SQL  works 


it  aui  even  call  methods  on  the  objects  in  the  collection.  And  LINQ 
loops  through  the  collection,  which  means  that  it  does  its  operations  in  a 
specific  order.  That  may  not  seem  all  that  important,  but  if  you’re  used 
to  dealing  with  SQL,  it  means  your  LINQ  queries  will  surprise  you  if 
you  expect  them  to  act  like  SQL. 
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that’s  why  jimmy  loves  linq 


LINQ  is  versatile 


You  can  do  a  lot  more  than  just  pull  a  few  items  out  of  a  collection. 

You  can  modify  the  items  before  you  return  them.  And  once  you’ve 
generated  a  set  of  result  collections,  LINQ  gives  you  a  bunch  of 
methods  that  work  with  them.  Top  to  bottom.  LINQ  gives  you  the 
tools  you  need  to  manage  your  data. 

Modify  every  item  returned  from  the  query 

Ibis  code  will  add  a  string  onto  the  end  of  each  string  in  an  array.  It  doesn't 
change  the  array  itself  it  creates  a  new  collection  of  modified  strings. 


string[]  sandwiches  =  (  "ham  and  cheese", 

"turkey  and  swiss 

var  sandwichesOnRye  = 

from  sandwich  in  sandwiches 
select  sandwich  +  "  on  rye"; 


"salami  with  mayo", 
"chicken  cutlet" 


**ds  the  string"  rye' 
■tc*  in  the  results  from  the 


foreach  (var  sandwich  in  sandwichesOnRye) 
Console. WriteLine (sandwich) ; 

T> 

Motile  that  all  the  items  reWd  have 
”  on  rye”  added  to  the  end 


<\uery 


every 


Output: 

ham  and  cheese  on  rye 
salami  with  mayo  on  rye 
turkey  and  swiss  on  rye 
chicken  cutlet  on  rye 


This  change  is 
made  to  the  items 
in  the  results  of 
your  guery...  but 
not  to  the  items 
in  the  original 
Collection  or 

database 


Perform  calculations  on  collections 


Remember,  we  said  LINQadds  new  methods  to  your  collections  (and 
database  access  objects)...  and  some  of  those  are  pretty  handy  on  their 
own,  without  actual  requiring  a  query: 

List<int>  listOfNumbers  =  new  List<int> ( )  ; 
int  length  =  random. Next (50,  150); 
for  (int  i  =  0;  i  <  length;  i++) 

listOfNumbers. Add (random. Next (100) ) ; 


c*  10  (which  is  part  of 
Vwl  Sl udio  2 0091  any 

y*  <*eate  has 
capabilities. 


Console. WriteLine ("There  are  (0)  numbers", 

1 i stOf Numbers . Count ( ) ) 
Console .WriteLine ("The  smallest  is  {0}", 

listOfNumbers .Min () ) 
Console .WriteLine ("The  biggest  is  {0}", 

listOfNumbers .Max () ) 
Console. WriteLine ("The  sum  is  {0}", 

listOfNumbers .Sum() ) ; 

Console .WriteLine ("The  average  is  (0:F2)", 

listOfNumbers . Average () ) 


None  of  these  methods 
are  part  of  the  NBT  ^ 

Collections  Classes  they  re 
all  def  ined  by  UNQ  ^ 

These  are  all  extension 
methods  def  ined  in  the 
Enumerable  class  in  the 
System-Ling  namespace- 
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Store  all  or  part  of  your  results  in  a  new  collection 

Sometimes  you’ll  want  to  keep  your  results  from  it  LINQ  query 
around.  You  can  use  the  ToList  ()  command  to  do  just  that: 

This  tiroCi  we  're 

var  under50sorted  = 

from  number  in  listOfNumbers 
where  number  <  50 

descending 


Watch  it! 


LINQ  queries 
aren’t  run  until 
you  access 
their  results! 


orderby  number 
select  number; 


sorting  d  list 

of  numbers 

descendm^  Wow> 
highest  to  lowest 


List<int>  newList  =  under50sorted. ToList () ; 

K 

You  can  even  take  just  a  subset  ol  the  results,  using 
the  Take  ()  method: 

var  firstFive  =  under50sorted.Take (6) ; 

List<int>  shortList  =  firstFive .ToList () 
foreach  (int  n  in  shortList) 

Console. WriteLine (n) ; 


It’s  called  “lazy 
evaluation" — the  LINQ  query 
doesn't  actually  do  any  looping 
until  a  statement  is  executed 
that  uses  the  results  of  the 
query.  That's  why  ToList() 
is  important:  it  tells  LINQ  to 
evaluate  the  query  immediately. 


var  into  a  list  object, 


ToUstO  Converts  a  LINQ 
SO  you  Can  keep  results  of  a  <\uevy  around 

dho  T^yO  and  ToDicWyO 
*et  Ods,  which  do  just  what  you'd  expect 

TakeO  pulls  out  the  supplied  number  °f  items, 
from  the  first  of  the  results  from  a  UN® 
<\uery  You  can  put  these  into  another  var, 
and  then  Convert  that  into  d  list 


Check  out  Microsoft's  official  “101  LINQ  Samples"  page 

There’s  way  more  that  LINQ, can  do.  Luckily,  Microsoft  gave  you  a  great  little  reference  to  help  you  along. 


http : //msdn2 .microsoft . com/en-us/vcsharp/aa336746.aspx 


there. ore  no 

Dumb  Questions 


Qj  That’s  a  lot  of  new  keywords— from, 
where,  orderby,  select...  it’s  like  a  whole 
different  language  Why  does  it  look  so 
different  from  the  rest  of  C#? 

Because  it  serves  a  different  purpose 
Most  of  the  C#  syntax  was  built  to  do  one 
small  operation  or  calculation  at  a  time  You 
can  start  a  loop,  or  set  a  variable,  or  do  a 
mathematical  operation,  or  call  a  method... 
those  are  all  single  operations. 

LINQ  queries  look  different  because  a  single 
LINQ  query  usually  does  a  whole  bunch  of 
things  at  once.  Let’s  take  a  closer  look  at  a 
straightforward  query: 


var  underlO  = 

from  number  in  numberArray 
where  number  <  10 
select  number; 

It  looks  really  simple— not  a  lot  of  stuff  there, 
right?  But  this  is  actually  a  pretty  complex 
piece  of  code.  Think  about  what’s  got  to 
happen  for  the  program  to  actually  select  all 
the  numbers  from  numberArray  that 
are  less  than  10.  First,  you  need  to  loop 
through  the  entire  array  Then,  each  number 
is  compared  to  10.  Then  those  results  need 
to  be  gathered  together  so  your  code  can 
use  them. 


And  that’s  why  LINQ  looks  a  little  odd: 
because  C#  has  to  cram  a  whole  lot  of 
behavior  into  a  very  small  space. 

LINQ  lets  you  write 
queries  that  Jo  very 
complex  things  using 
very  little  coJe. 


you  are  here  ► 
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a  little  review 


BULLET  POINTS 


■  from  is  how  you  specify  the  collection  that  you're 
querying.  It’s  always  followed  by  the  name  of  a 
variable,  followed  by  in  and  the  name  of  the 
collection  (from  value  in  values). 

■  where  generally  follows  the  from  clause.  That's 
w  here  you  use  normal  C#  conditions  to  tell  LINQ 
which  items  to  pull  out  of  the  collection  (where 
value  <  10). 

■  orderby  lets  you  order  the  results.  It’s  followed 
by  the  criteria  that  you’re  using  to  sort  them,  ami 
optionally  descending  to  tell  it  to  reverse  the 
sort  (orderby  value  descending). 


select  is  how  you  specify  what  goes  into  the 
results  (select  value). 

Take  lets  you  pull  the  first  items  out  of  the  results 
of  a  LINQ  query  (results  .Take  (10) ).  LINQ 
gives  you  oilier  methods  for  each  collection: 

Min  ( ) ,  Max  ( ) ,  Sum  ( ) ,  and  Average  ( ) . 

You  can  select  anything — you’re  not  limited  to 
selecting  the  name  that  you  created  in  the  from 
clause.  Here’s  an  example:  if  your  LINQquery 
pulls  a  set  of  prices  out  of  an  array  of  int  values 
and  names  them  value  in  the  from  clause, 
you  can  return  a  collection  of  price  strings  like 
this:  select  String. Format  ("{0:c}", 
value. 


CThis  is  just  like  -the  [0:s]  you  used  in  Chapter  ^ 
when  you  built  the  h e*  dumper  There’s  also  {0&} 
and  {O  D}  £or  short  and  lon<)  dates,  and  {O  P }  or 
{O  Pn}  to  print  a  percent  (with  n  decimal  plates) 


the rejore  no 

Dumb  Questions 


How  does  the  from  clause  work? 


I \ I  It  s  a  lot  like  the  first  line  of  a 
f  oreach  loop.  One  thing  that  makes 
thinking  about  LINQ  queries  a  little  tricky 
is  that  you're  not  just  doing  one  operation. 
Most  C#  statements  just  do  one  single  thing. 


A  LINQ  query  does  the  same  thing  over  and 
over  again  for  each  item  in  a  collection.  The 
from  clause  does  two  things:  It  tells  LINQ 
which  collection  to  use  for  the  query,  and  it 
assigns  a  name  to  use  for  each  member  of 
the  collection  that's  being  queried. 


The  way  the  from  clause  creates  a  new 
name  for  each  item  in  the  collection  is  really 
similar  to  how  a  f  oreach  loop  does  it. 
Here's  the  first  line  of  a  f  oreach  loop: 


f oreach  (int  i  in  values) 

That  foreach  loop  temporarily  creates 
a  variable  called  i,  which  it  assigns 
sequentially  to  each  item  in  the  values 
collection  Now  look  at  a  from  clause  in  a 
LINQ  query  on  the  same  collection: 

from  i  in  values 

That  clause  does  pretty  much  the  same  thing 
It  creates  a  temporary  variable  called  i  and 
assigns  it  sequentially  to  each  item  in  the 
values  collection  The  foreach  loop 
runs  the  same  block  of  code  for  each  Item  in 
the  collection,  while  the  LINQ  query  applies 
the  same  criteria  in  the  where  clause 
to  each  item  in  the  collection  to  determine 
whether  or  not  to  include  it  in  the  results. 


Q: 


How  does  LINQ  decide  what  goes 
into  the  results? 


That's  what  the  select  clause  is 
for  Every  LINQ  query  returns  a  collection, 
and  every  item  In  a  collection  is  of  the  same 
type.  It  tells  LINQ  exactly  what  that  collection 
should  contain.  When  you're  querying  an 
array  or  list  of  a  single  type— like  an  array 
of  intsora  List<string>— it’s 
obvious  what  goes  into  the  select 
clause.  But  what  if  you’re  selecting  from  a 
list  of  Comic  objects?  You  could  do  what 
Jimmy  did  and  select  the  whole  class.  But 
you  could  also  change  the  last  line  of  the 
query  to  select  comic.  Name  to 
tell  it  to  return  a  collection  of  strings.  Or 
you  could  do  select  comic.  Issue 
and  have  it  return  a  collection  of  ints. 
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LINQ  Magnets 

Rearrange  the  magnets  so  they  produce 
the  output  at  the  bottom  of  the  page. 


pigeon  descending 


Output: 

Get  your  kicks  on  route  66 


{  36,  5,  91,  3,  41,  69,  8  }; 
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are  you  a  LINO  groupie? 


LINQ  Magnets  Solution 

Rearrange  the  magnets  so  they  produce 
the  output  at  the  bottom  of  the  page. 


LIN®  tUrb  with  so""e  sor^ 
of  Collection  or  array-in  this 
case,  an  array  of  integers 


int[]  badgers  = 


^on  in  badgers"  makes  fc 


J|  8  }  ;  | 


‘""^able  UNQ 

**»*  readable-  ^  Y  on,  badger  in  badgers"  i, 

\  i 


var  skunks  = 


Mler  ibis  statement, 
skunks  Contains  four 
numbers:  H  /3,  IQ  and  g  r 


f  rom 


where 


E 


pigeon  in  badgers 


1 


(pigeon  !-  36  &&  pigeon  <  50) 


or derby  [  pigeon  descending 


select 


pigeon  +  5; 


] 


] 


This  L|NQ  statement  fulls 
all  the  numbers  that  are 
below  50  and  not  egual  to 
V>  out  of  the  array,  adds  5 
to  each  of  them,  sorts  them 
fir  Ol*  biggest  to  smallest,  and 
puts  them  in  a  new  Collection 
called  skunks 


After  this 
statement,  bea 
Contains  three  j\ 

numbers:  A"b,  1^  - / 

and  10 


—  -  ^*e  the  first  three 

Collection  called  bears 


statement, 

Contains 

Ambers  11,  3nd  % 


This  statement  just  subtracts  I  from 
each  number  in  bears  and  puts  them 
all  into  weasels. 


WriteLine ("Get  your  kicks  on  route  (0) 


*5  +  II  +  <\  =i  it 


nO  [);  | 


□ 


Output: 

Get  your  kicks  on  route  66 
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LINQ  can  combine  your  results  into  groups 

You  already  know  that  you  can  use  IJNQ.  to  build 
your  results  into  groups,  because  that’s  what  we  did 
with  the  beehive  simulator.  Let's  take  a  closer  look  at 
that  query  and  see  how  it  works. 


var  beeGroups  = 


The  query  starts  out  just  like  the  other  queries  you’ve 
seen — by  pulling  individual  bee  objects  out  of  the 
world. Bees  collection,  a  List<Bee>  object. 


from  bee  in  world. Bees 


group 


r^Dee  by 


bee . CurrentState 


into  beeGroup 


orderby  beeGroup . Key 


select  beeGroup; 


Now  we  just  have  to  use  the  select 
keyword  to  indicate  what’s  being  returned 
by  the  query.  Since  we’re  returning 
groups,  we  select  the  group  name: 

select  beeGroup; 


The  next  line  in  the  query  has  a  new  keyword: 
group.  This  tells  the  query  to  return  groups 
of  bees.  What  that  means  is  that  rather  than 
returning  one  single  collection,  the  query 
will  return  a  collection  of  collections, 
group  bee  by  bee .  CurrentState  tells 
LINQ  to  return  one  group  for  each  unique 
CurrentState  properly  that  it  linds  in  the 
bees  that  it  selects.  Finally,  we  need  to  give 
LINQa  name  lor  the  group.  That’s  what  the 
next  line  is  for:  into  beeGroup  says  that  the 
name  “beeGroup”  refers  to  the  new  groups. 


Now  that  we’ve  got  groups,  we  can  manipulate  them. 
Since  we’re  returning  a  collection  of  groups,  we 
can  use  the  orderby  keyword  to  put  the  groups 
in  order  of  the  CurrentState  enum  values  (Idle, 
FKingTo Flower,  etc.):  orderby  beeGroup .  Key 
tells  the  query  to  put  the  collection  of  groups  in  order, 
sorting  them  by  the  group  key.  Since  we  grouped  the 
bees  by  their  CurrentState,  that’s  what  being 
used  as  a  key. 
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the  key  to  success 


Combine  Jimmy's  values  into  groups 


Jimmy  buys  a  lot  of  cheap  comic  books,  some  midrange  comic  books,  and  a  few  expensive  ones,  and  he  wants 
to  know  what  his  options  are  before  he  decides  what  comics  to  buy.  He’s  got  those  prices  he  got  from  Greg’s  List 
and  put  into  a  Dictionarycint,  int>  using  his  GetPrices  ()  method — let’s  use  LINQjo  group  them 
into  three  groups:  one  for  cheap  comics  that  cost  under  3100,  one  for  midrange  comics  that  cost  between  $100 
and  $1000,  and  expensive  ones  that  cost  over  $1000.  We’ll  create  a  PriceRange  enum  dial  we’ll  use  as  the 
key  for  the  groups,  and  a  method  called  EvaluatePrice()  that'll  evaluate  a  price  and  return  a  PriceRange. 


Every  group  needs  a  key— we’ll  use  an  enum  for  that 

The  group’s  key  is  the  thing  diat  all  of  its  members  have  in  common.  The  key  can  be  anything:  a 
string,  a  number,  even  an  object  reference.  We'll  be  looking  at  the  prices  that  Jimmy  got  from  Greg’s 
list.  Each  group  that  the  query  returns  will  be  a  collection  of  issue  numbers,  and  the  group’s  key  will 
be  a  PriceRange  enum.  And  the  EvaluatePrice  ( )  method  takes  a  price  as  a  parameter  and 
returns  a  PriceRange: 


public  enum  PriceRange  (  cheap,  midrange,  expensive  } 


public  PriceRange  EvaluatePrice (int  price)  ( 
if  (price  <  100)  return  PriceRange. cheap; 
else  if  (price  <  1000)  return  PriceRange. midrange; 
else  return  PriceRange. expensive; 

1 

Now  wc  can  group  the  comics  by  their  price  categories 

The  LINf)  query  returns  a  collection  of  collections.  Each  of  the  collections  inside  the  results  has 
a  Key  property,  which  matches  the  PriceRange  that  was  returned  by  EvaluatePrice  ( ) .  1-ook 
closely  at  the  group  by  clause  -we’re  pulling  pairs  out  of  the  Dictionary,  and  using  the  name  pair 
for  each  of  them:  pair .  Key  is  the  issue  number,  and  pair .  Value  is  the  price  from  Greg’s  list. 
Adding  group  pair  .  Key  tells  LINQto  create  groups  of  issue  numbers,  and  then  bundles  all  of  those 
groups  up  based  on  die  price  category  that's  returned  by  EvaluatePrice  ( ) : 


Dictionarycint,  int>  values  =  GetPrices (); 

var  priceGroups  = 

from  pair  in  values 
group  pair. Key  by  EvaluatePrice (pair .Value) 
into  priceGroup 

orderby  priceGroup. Key  descending 
select  priceGroup; 


The  <\uery  Quires  out  which  group  a 
particular  price  belongs  to  by  sending 
its  pride  to  EvaluateFViCeO.  That 
returns  a  PriceRange  enum,  which  it 
uses  as  the  group  s  key 


foreach  (var  group  in  priceGroups)  ( 

Console. Write  ("I  found  (0)  (1)  comics:  issues  ",  group. Count () ,  group. Key ) ; 
foreach  (var  price  in  group) 


Console . Write (price . ToString ( ) 
Console .WriteLine ( ) ; 

1 

Each  of  the  groups  is  a  Collection,  so 
we  added  an  inner  foreach  loop  to  pull 
each  of  the  prices  out  of  the  group. 

Chapter  15 


') ; 


Show  output  from:  Debug 


I  found  2  expensive  comics:  issues  6  57 
I  found  3  midrange  comics:  Issues  19  36  68 
I  found  3  cheap  comics:  Issues  74  83  97 
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Pod]  Puzzle 

Your  job  is  to  take  snippets  from  the 
pool  and  place  them  into  the  blank 
lines  in  the  program.  You  can  use 
the  same  snippet  more  than  once, 
and  you  won't  need  to  use  all  the 
snippets.  Your  goal  is  to  make  the 
code  produce  this  output: 


Horses  enjoy  eating  carrots,  but  they  love  eating  apples. 


var  _  = 

from  _  in  _ 

_  line  by  line. 

into  wordGroups 

orderby  _ . _ 

select  _ ; 


public  class  Line  { 

public  string []  Words; 
public  int  Value; 

public  Line (string []  Words,  int  Value)  { 

this. Words  =  Words;  this. Value  =  Value; 


=  words  . _ ( 2 ) ; 


foreach  (var  group  in  twoGroups) 
( 

int  i  =  0; 


1  Mint  LINQ  sorts  striny  in 

alphabetical  order. 

Line[]  lines  =  { 

new  Line (  {  "eating",  "carrots,", 

"but",  "enjoy",  "Horses"  )  ,  1), 
new  Line  (  {  "zebras?",  "hay", 

"Cows",  "bridge.",  "bolted"  )  ,  2)  , 
new  Line (  {  "fork",  "dogs!", 

"Engine",  "and"  },  3  )  , 
new  Line (  (  "love",  "they", 

"apples.",  "eating"  ),  2  )  , 
new  Line (  {  "whistled.",  "Bump"  ),  1  )  ); 


foreach  ( _  inner  in  _ )  ( 

i++; 


if  (i  ==  _ .Key)  ( 

var  poem  = 


word  in  _ . _ 

_  word  descending 
word  +  _ ; 


foreach  (var  word  in  _ ) 

Console .Write (word) ; 


) 


) 


Line[] 

lines 

new 

line 

group 

groups 

wordGroups 

twoGroups 


select 

inside 

outside 

orderby 

into 

output 


talk 

word 

Take 

poem 

write 

length 


int 

string 

var 


Value 

Key 

Words 

words 

this 

inner 


by 

Key 

Value 


Note:  each  snippet 
from  the  pool  can  be 
used  more  once! 
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that’s  the  last  pool  puzzle  in  the  book 


public  class  Line  { 

public  string []  Words; 
public  int  Value; 

public  Line (string []  Words,  int  Value)  { 

this. Words  =  Words;  this. Value  =  Value; 

) 

) 


P00]  plizzjc 


Line[]  lines  =  ( 

new  Line (  new  (  "eating",  "carrots,",  "but",  "enjoy",  "Horses"  )  ,  1), 
new  Line (  new  {  "zebras?",  "hay",  "Cows",  "bridge.",  "bolted"  )  ,  2), 
new  Line(  new  (  "fork",  "dogs!",  "Engine",  "and"  ),  3  )  , 
new  Line(  new  (  "love",  "they",  "apples.",  "eating"  ),  2  )  , 
new  Line(  new  (  "whistled.",  "Bump"  },  1  ) 


var  words  - 


from  line  in  lines 
Qroup  line  by  line. Value 
into  wordGroups 
orderby  wordGroups .  Key 
select  wordGroups; 


var  twoGroups  =  words  .Take  (2) ; 


V*  W  UNS)  ^  di.y„  ^  ^ 
bjett  ,»  tkt  Im£I  it,fe  ^ 

The  •first  two  groups  are  the 
lines  with  Valv.es  I  and  2- 


foreach  (var  group  in  twoGroups) 

t  _ _ This  Ioop  does  a  LIN#  ^ery 

int  i  =  0;  ^  ^  Line  object » the 

foreach  (var  inner  in  group )  (  first  youp  and  the  second  Line 

i++'  obvett  in  the  setond  youp 

if  (i  ==~  qroup .Key)  { 
var  poem  = 

from  word  in  inner. Words  tvj  ..  r  ,  ,,  , 

1  j  ,  .  - - -  ^  D id  you  Lyre  out  that  the 

orderby  word  descending  '  - 

select  word  + 


■  .  Did  you  tiyre  out  that  the 

two  phrases  “Horses  enjoy  eating 
Carrots,  but”  and  “thev  I 


,  ,  Carrots,  but  and  they  love 

foreach  (var  word  in  poem'  1.  ,  »  ,  1 

£ -  eatm«  apples  are  in  descending 

Console. Write  (word) ;  a|?habetical  order? 


Output:  Horses  enjoy  eating  carrots,  but  they  love  eating  apples. 
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Use  join  to  combine  two  collections  into  one  query 


Jimmy’s  got  a  whole  collection  of  comics  he’s  purchased,  and  he  wants  to  compare  them  with  the 
prices  he  found  on  Greg’s  List  to  see  if  the  prices  he’s  been  getting  are  better  or  worse.  He's  been 
tracking  his  purchases  using  a  Purchase  class  with  two  fields,  Issue  and  Price.  And  lie’s  got  a 
List<Purchase>  called  purchases  that's  got  all  the  comics  lie's  bought.  But  now  he  needs  to 
match  up  the  purchases  he’s  made  with  the  prices  he  found  on  Greg’s  List.  How’s  he  going  to  do  it? 

LINO  (o  the  rescue!  Its  join  keyword  lets  you  combine  data  from  two  collections  into  a 
single  query.  It  does  it  by  comparing  items  in  the  first  collection  their  matching  items  in  the  second 
collection.  (LINQ is  smart  enough  to  do  this  efficiently — it  doesn't  actually  compare  every  pair  of 
items  unless  it  has  to.)  The  end  result  is  a  final  result  that  combines  every  pair  that  matches. 


Start  oil'  your  query  with  the  usual  from  clause. 

But  instead  of  following  it  up  with  the  criteria  it'll 
use  to  determine  what  goes  into  the  results,  you  add: 
join  name  in  collection 

The  join  clause  tells  LINQ  to  loop  through  both 
collections  to  match  up  pairs  of  one  member  from 
each  collection.  It  assigns  name  to  the  member  it'll 
pull  out  of  the  joined  collection  in  each  iteration. 

You'll  use  that  name  in  the  where  clause. 

Jimmy's  joining  his  Com  ids  \ 

Jo  purchases,  a  list  V 
of  domids  he's  bought 

You1  ve  already  seen  anonymous  types 
Men  you  use  an  object  initializer, 
you  Create  an  anonymous  by  typing 
^  of  names  and  values  inside 
Curly  brackets.  ^ 

You’ll  continue  the  LINQ  query' 
with  where  and  orderby 
clauses  as  usual.  You  could  finish 
it  with  a  normal  select  clause, 
but  you  usually  want  to  return 
results  that  pulls  some  data  front 
one  collection  and  other  data 
from  the  other.  That’s  where 
you  use  select  new  to  create 
a  custom  set  of  results  using  an 
anonymous  type. 


Jimmy's  got  bis  data  in  a  Collection  of 
purchase  objects  called  purchases 


public  class  Purchase  ( 
public  int  Issue 

(  get;  set;  ); 
public  int  Price; 

{  get;  set;  ); 

) 


on  comic. Issue 
equals  purchase . Issue 

The  select  new  is 
followed  by  Curly  brackets 
that  contain  the  data  to 
return  in  the  result^ 


L 


Next  you’ll  add  the  on  clause,  which 
tells  LINQ  how  to  match  the  tw  o 
collections  together.  You’ll  follow'  it 
with  the  name  of  tire  member  of 
the  first  collection  you're  matching, 
followed  by  equals  and  the  name  of 
the  member  of  the  second  collection  to 
match  it  to. 


▼ 

f  results  1  ^ 


select  new  { 

comic. Issue, 


comic .Name, 
purchase . Price 


|  Issue  =  6| 

name  =  ‘Johnny  America"  |  Price  =  3600  | 

Issue  =  19  name  =^oc|^n^RolM 

|^lssu^^7 

name  = 

you  are  here  ► 
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jimmy’s  a  joiner 


Jinwiy  saved  a  bunch  of  dough 

It  looks  like  Jimmy  drives  a  hard  bargain.  He  created  a  list  of 
Purchase  classes  that  contained  his  purchases,  and  compared  them 
with  the  prices  he  found  on  Greg’s  List. 


First  Jimmy  created  his  collection  to  join. 

Jimmy  already  had  his  first  collection — he  just  used  his  BuildCatalog  ( )  method  from  before.  So 
all  he  had  to  do  was  write  a  FindPurchases  ( )  method  to  build  his  list  of  Purchase  classes. 


public  sList<Purchase>  FindPurchases ( )  ( 

List<Purchase>  purchases  =  new  List<Purchase> () 


< 


new  Purchase ( ) 
new  Purchased 
new  Purchased 
new  Purchase ( ) 
new  Purchased 

>; 

return  purchases; 


{  Issue  =  68,  Price  =  225  }, 

(  Issue  =  19,  Price  =  375  }, 

{  Issue  =  6,  Price  =  3600  }, 

(  Issue  =  57,  Price  =  13215  J, 

(  Issue  =  36,  Price  =  660  ), 


paid  f/3,2J5 

(or  issue  #57. 


Now  he  could  do  the  join! 

You've  seen  all  the  parts  of  this  query  already...  now  here  they  are,  put  together  in  one  piece. 


List<Comic>  comics  =  BuildCatalog d ; 

Dictionary<int,  int>  values  =  GetPricesd; 

List<Purchase>  purchases  =  FindPurchases ( ) 
var  results  = 

from  comic  in  comics 
join  purchase  in  purchases 
on  comic. Issue  equals  purchase. Issue 
orderby  comic. Issue  ascending 
select  new  {  comic. Name,  comic. Issue, 

int  gregsListValue  =  0; 
int  totalSpent  =  0; 
foreach  (var  result  in  results)  { 

gregsListValue  +=  values [result . Issue] 
totalSpent  +=  result. Price; 

Console. WriteLine ("Issue  1(0)  ((1))  bought  for  ( 2 : c  > ' 

result . Issue,  result. Name,  result. Price) ; 

) 

Console. WriteLine ("I  spent  (0:c)  on  comics  worth  {l:c}", 
totalSpent,  gregsListValue); 


Men  Jimmy  used  a  join  clause,  UNQ 
Compared  every  item  in  tbe  comics 
Collection  with  each  -tem  in  purchases  to 
*e  wb.cb  ones  have  comic. Issue  e<\ual  to 
purchase . Issue 


purchase . Price  ) ; 

Tke  select  new  clause  Creates  a  result 
set  with  Name  and  Issue  -from  tbe 
comic  member,  and  Price  trom  tbe 
purchase  **cr*ber 


5/  pux< 


jimmy  S 


real  Kappy 

that  be  knows  L-|  N$, 
because  it  let  him 
see  just  bow  bard  a 
bargain  be  can  drwe^ 


1  Show  output  from :  Debug 

Issue  #6  (Johnny  America  vs.  Che  Pinko)  bought  for  $3,600.00 
Issue  #19  (Rock  and  Roll  (limited  edition))  bought  for  $375.00 
Issue  #36  (Homan's  Bork)  bought  for  $660.00 

Issue  #57  (Hippie  Badness  (misprinted))  bought  for  $13,215.00 
Issue  #68  (Revenge  of  the  Neu  Have  Freak  (damaged))  bought  for  $225.00 
spent  $18,075.00  on  comics  worth  $18,525.00 
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Okay,  so  now  I  know  Jimmy  played  with 
his  comic  books  using  LINQ  queries  to 
query  his  collections...  but  what  about  the 
Starbuzz  promotion  problem?  I  still  don't 
see  how  LINQ  works  with  databases. 


LINQ  uses  the  same  syntax  with 
databases  as  it  does  with  collections. 

You've  already  seen  in  Chapter  1  how  easy  .NET  makes 
it  to  work  with  a  database.  The  IDE  gives  you  a  really 
convenient  way  to  connect  with  databases,  add  tables,  and 
even  link  data  in  those  tables  to  vour  forms. 


Eve*  though  LINQ 
to  is  very 
different  under  the 
hood,  when  you  write 
your  code  it  looks 
really  similar  to  other 
Queries. 


Now;  you  can  take  that  same  database  you  already 
connected  to  and  query'  it  with  LINQ.  Not  only  that, 
LINQ.  lets  you  combine  your  data  from  your  database  with 
data  from  your  objects  seamlessly. 

In  fact,  you  can  use  the  same  exact  query  syntax...  all  you 
need  is  to  get  access  to  your  database  so  you  can  run  a 
LINQ  query  against  it. 


The  StaeBuzj. 
£re<\uent  Customer 
data’s  here 


'  ContactDB 
database 

The  Dbjectville 
Contact  Database 
has  the  addresses. 


\ 


results 


Ji 


'A/Q  Co^ 


We  can  use  L|N$  to 
Compare  and  Combine 
data  £r  om  more  than 
one  source  and  create  a 
Collection  o£  results- 


you  are  here  ► 
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bring  it  all  together 


Connect  LING  to  a  SQL  database 


UNQ. operates  on  collections  that  implement  the  IEnumerable  interface,  right?  So  it 
should  make  sense  that  you  access  your  SQL  database  using  an  object  that  implements 
IEnumerable.  And  C#  makes  it  easy  to  add  that  object  to  your  project. 


Add  the  Objectville  Contact  Database  to  a  new  project 

Bark  in  Chapter  I,  you  created  a  database  of  contacts  for  the  Objectville  Paper  Company 
and  sat  ed  it  in  a  file  called  ContactDB  .mdf .  Start  a  new  Windows  Application  project, 
right-click  on  your  project  in  the  Solution  Explorer,  select  “Add  Existing  Item”  and  add  the 
database.  Make  sure  you  select  “Data  Files”  from  the  “Objects  of  Type”  filter  list. 


The  IDE  will  pop  up  the  Data  Source  Configuration  Wizard 

Choose  the  People  table  by  selecting  its  checkbox.  Click  Finish  the  w  izard  will  create  a 
dataset  called  ContactDBDataSet  and  add  it  to  your  project  automatically. 


This  is  'the  same 
wizard  that  you  used 
in  Chapter  I  when 
you  first  treated  the 
database  It  adds 
classes  to  your  project 
that  let  you  access  the 
database  directly 

V  n 

Take  a  minute  and  -Flip 
back  to  Chapter  I  to 
see  how  you  built  it- 


Data  Source  Configuration  Wizard 


Choose  Your  Database  Objects 


Which  database  objects  do  you  want  n  your  dataset? 

T|7|3  Tattes 
b  |ur$J  People 

3  Cent*® 

3  Name 
3  Company 
3  Telephone 
3  Emat 
3  Clent 
3  LastCal 
Views 

Stored  Procedures 
Functions 


DataSet  name: 

CcntactDeOataSet 


<  Previous 


Fnsh 


Cancel 


Add  the  UNQ  to  SQL  Classes  to  your  project 

Right-click  on  the  project  in  the  Solution  Explorer  and  choose  “Add  New  Item”.  It'll  display 
the  familiar  list  of  icons — choose  the  LINQto  SQL  Classes  and  call  it  ContactDB  .dbml. 


When  you  add  the  L ISQ  to  SQL  Classes  to  your 
project,  the  IDE  automatically  adds  a  collection 
class  to  your  project  that  you  can  use  with  LIHQ 
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The  IDE  has  a  designer  to  build  your  SQL  collection 

As  soon  as  you  add  the  LINQto  SQL  Classes  to  your  project,  the  II  )K  pops  up  an  empty 
window  called  the  Object  Relational  Designer.  Here’s  what  it  looks  like: 


ContactDB.dbml 


The  Object  Relational  Designer  alows  you  to  vtsuabe  data  classes  in  you-  code. 

Create  data  classes  by  draggng  items  Iron i  Database  Explorer  or  Toofcox  coto  thts  design  surface. 

<  din.  L--Z  ~  > 


Drag  the  People  table  to  the  Object  Relational  Designer 

Click  on  the  Database  Explorer  link  in  the  ( )bject  Relational  Designer  window  the  IDE  will 
pop  up  a  Database  Explorer  window.  Expand  the  Tables  node,  click  on  the  People  table  icon, 
drag  it  into  the  Object  Relational  Designer  window;  and  save  the  project. 


The  DataCont«*t  is  a 
little  boo  smart  -for  rts 
own  ^ood  It  knows  that 
i-t’s  $ot  a  People  table,  so 
rt  assumes  that  the  table 
Contains  a  bunch  of  rows, 
one  for  each  "People"-  so 
it  has  a  member  called 
Peoples  to  Contain  each 
individual  People 


Database  Exptorer  w 

ns  % 

a  rj|  Data  Corrections 
a  U,  CcntactDe.mdf 
m  a  Database  Diagrams 
a  a  Tables 
a  3  People 

31  Contact© 

31  Name 
31  Company 
31  Telephone 
31  Emal 
31  Ctent 
3)  Las  teal 
*  3  Views 

a  a  Stored  Procedu-es 


d  X 


ContdctDB.dbni! 


Pt»OfJ*P 

sr| 

s  Properties 

Contact© 

#  Name 
^  Company 
Telephone 

Emal 
ip  dent 
if  LastCat 

■- 

„  < 


fa  soon  as  you  save 
the  project,  the 
IDE  automatically 
adds  a  class  called 
a  DataConte*t  to 
your  project— one  of 
its  properties  is  the 
Collection  you  Can 
<y»ery  with  L|M$, 
which  is  Connected 
to  the  database 


You're  all  set  to  write  LINQ  queries  that  pull  data  out  of  the  database 

Add  a  button  to  the  form — here’s  the  code  for  it.  Notice  how  we  used  the  select  new 
keyword  to  create  custom  results  that  only  contain  the  Name  and  Company. 


ContactDBDataContext  context  =  new  ContactDBDataContext () ; 

,  _  _ ^ft  some  practice  usina  select  new 

var  peopleData  -  It'll  fjl  the  the  Na„e  a.d 

fro,  person  in  context .  Peoples  ^  Co-fJ.y  £ol...i  the  daUbji, 


select  new  {  person. Name,  person. Company  }; 


foreach  (var  person  in  peopleData) 

Console .WriteLine ("( 0 )  works  at  11}",  person. Name,  person. Company ) ; 


you  are  here  ► 
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two  collections  walk  into  a  var 


BULLET  POINTS 


■  The  group  clause  tells  LINQ  to  group  the 
results  together— when  you  use  it,  LINQ  creates  a 
collection  of  group  collections. 

■  Every  group  contains  members  that  have  one 
member  in  common,  called  the  group’s  key  Use 
the  by  keyword  to  specify  the  key  for  the  group. 
Each  group  collection  has  a  Key  member  that 
contains  the  group  s  key. 

■  Use  a  j  oin  clause  to  tell  LINQ  to  combine  two 
collections  into  a  single  query  When  you  do,  LINQ 
compares  every  member  of  the  first  collection  with 
every  member  of  the  second  collection,  including 
the  matching  pairs  in  the  results. 

■  Join  queries  use  an  on  equals  clause  to  tell 
LINQ  how  to  match  the  pairs  of  items. 


When  you’re  doing  a  join  query,  you  usually  want  a 
set  of  results  that  includes  some  members  from  the 
first  collection  and  other  members  from  the  second 
collection.  The  select  new  clause  lets  you 
build  custom  results  from  both  of  them 

LINQ  can  query  a  SQL  database  using  the  LINQ 
to  SQL  Classes  Since  LINQ  only  works  with 
collections  that  implement  lEnumerable,  they 
provide  a  collection  that  lets  you  access  the  tables 
and  queries  as  if  they  were  a  collection 

The  IDE's  Object  Relational  Designer  lets  you 
choose  the  tables  that  you  want  to  access  via 
LINQ.  When  you  specify  the  tables  you  want  to 
access,  it  adds  a  DataContext  class  to  your  project. 
When  it's  instantiated,  add  its  members  to  your 
LINQ  quenes  to  access  the  SQL  tables. 


there  icire  nP 

Dumb  Questions 


Can  you  rewind  a  minute  and  explain  what  var  is  again? 


Yes.  definitely.  The  var  keyword  solves  a  tricky  problem  that 
LINQ  bnngs  with  it.  Normally,  when  you  call  a  method  or  execute  a 
statement,  it’s  absolutely  clear  exactly  what  types  you’re  working  with. 
If  you  ve  got  a  method  that  returns  a  string,  for  instance,  then 
you  can  only  store  its  results  in  a  string  variable  or  field. 

But  LINQ  isn’t  quite  so  simple,  When  you  build  a  LINQ  statement,  it 
usually  returns  a  type  that  isn't  defined  anywhere  in  your  program. 
Yes,  you  know  that  it's  going  to  be  a  collection  of  some  sort.  But  what 
kind  of  collection  will  it  be?  You  don't  know— because  the  objects  that 
are  contained  in  the  collection  depend  entirely  on  what  you  put  in 
your  LINQ  query. 


Take  this  query,  for  example: 

var  mostExpensive  = 

from  comic  in  comics 

where  values [comic. Issue]  >  500 

select  comic; 

What  if  you  changed  the  last  line  to  this: 

select  comic. Issue; 

That's  a  perfectly  valid  LINQ  query.  Instead  of  returning  a  collection  of 
Comic  objects,  it’ll  return  a  collection  of  values.  And  that  presents 
a  problem  for  C#— those  are  two  different  types,  and  we'd  have  to 
add  extra  statements  to  define  those  types.  So  instead,  C#  gives  us 
the  var  keyword,  which  tells  the  compiler,  ‘Okay,  we  know  that  this 
is  a  valid  type,  but  we  can’t  exactly  tell  you  what  it  is  right  now.  So 
why  don’t  you  just  figure  that  out  yourself  and  not  bother  us  with  it? 
Thanks  so  much." 
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Qj  I  don't  quite  get  how  join  works. 

Join  works  with  any  two  collections 
Let  s  say  you’ve  got  a  collection  of  football 
players  called  players— its  items  are 
objects  that  have  a  Name  property,  a 
Position  property  and  a  Number 
property  So  we  could  pull  out  the  players 
whose  jerseys  have  a  number  bigger  than 
10  with  this  query: 

var  results  = 
from  player  in  players 
where  player .Number  >  10 
select  player; 

Let's  say  we  wanted  to  figure  out  each 
player's  shirt  size,  and  we  ve  got  a 
jerseys  collection  whose  items  have  a 
Number  property  and  a  Size  property.  A 
join  would  work  really  well  for  that: 

var  results  = 
from  player  in  players 
where  player . Number  >  10 
join  shirt  in  jerseys 
on  player .Number 
equals  shirt. Number 
select  shirt; 

o 

Hold  on,  that  query  will  just  give 
me  a  bunch  of  shirts.  What  if  I  want  to 
connect  each  player  to  his  shirt  size,  and 
I  don’t  care  about  his  number  at  all? 

That's  what  select  new  is  for. 

It  lets  you  construct  an  anonymous  type 
that  only  has  the  data  you  want  in  it.  And  it 
lets  you  pick  and  choose  from  the  various 
collections  that  you’re  joining  together,  too. 


the reiore  no 

Dumb  Questions 


So  you  can  select  the  player's  name  and  the 
shirt's  size,  and  nothing  else: 

var  results  = 
from  player  in  players 
where  player .Number  >  10 
join  shirt  in  jerseys 
on  player .Number 
equals  shirt. Number 
select  new  { 

player .Name, 
shirt . Size 


The  IDE  is  smart  enough  to  figure  out  exactly 
what  results  you'll  be  creating  with  your 
query.  If  you  create  a  loop  to  enumerate 
through  the  results,  as  soon  as  you  type 
the  variable  name  the  IDE  will  pop  up  an 
IntelliSense  list. 

foreach  (var  r  in  results) 
r . 

♦  Equals 

♦  GetHashCode 

♦  GetType _ I 


Name 


see 

♦  ToString 


Notice  how  the  list  has  Name  and  Size  in 
it.  If  you  added  more  items  to  the  select 
new  clause,  they'd  show  up  in  the  list 
too  That’s  because  the  query  would  create 
a  different  anonymous  type  with  different 
members. 


But  does  that  only  work  with  joins? 


No,  you  can  use  select  new  with 
any  LINQ  query  where  you  want  to  build  a 
results  collection  that  only  includes  certain 
items  in  it. 

o 

Do  I  always  have  to  add  those  LINQ 
to  SQL  Classes  if  I  want  to  use  LINQ  to 
query  a  SQL  database?  What  are  they? 

Yes,  you  do  have  to  create 
them.  LINQ  object  that  implements 
the  IEnumerable  interface.  A  SQL 
database  doesn't  normally  implement  that 
interface...  or  any  interface,  really,  because 
it’s  not  an  object.  So  if  you  want  LINQ  to 
work  with  SQL— or  any  other  source  of  data 
that  you  can  query— then  you  need  an  object 
that  interacts  with  it  and  implements  the 
IEnumerable  interface 

That’s  why  the  IDE  provides  the  LINQ  to 
SQL  classes  for  you.  When  you  add  it  to 
your  project,  it  automatically  does  everything 
you  need  in  order  to  connect  LINQ  to  a 
SQL  database:  it  lets  you  drag  database 
objects  into  its  Object  Relational  Designer, 
and  when  you  do  it  automatically  reads 
your  database  s  tables  and  creates  classes 
(like  the  People  class)  that  LINQ  can  use  to 
access  them. 

You  can  use  select 
new"  to  construct 
custom  LINQ  query 
results  that  include 
only  the  items  that 
you  want  in  your 
result  collection. 


you  are  here  ► 


677 


that’s  all  folks 


Use  a  join  query  to  connect 
Starbuzz  and  Objectville 

Now  you  have  all  the  tools  that  you  need  to  combine  the  data  from 
Starbuzz  and  Objectville  Paper  Company  into  one  final  result  set. 

Add  the  SQL  data  to  your  project 

If  you  haven’t  already  done  it,  create  a  new  Windows  application  project  and  add  the 
Contact] )B  SOL  database  to  it.  Then  add  the  LIN Q. to  SQL  classes  to  the  project,  and 
write  a  simple  test  query  just  to  make  sure  it's  all  working. 


■Dotfus  % 


^etStarbuzzDataO 

uses  a  Collection 
initializer  ahd  object 
initializers  to  set  up 
tbe  Starbuzz  objects. 


Build  the  Starbuzz  objects 

Here  's  the  list  that  contains  the  Starbuzz  customer  data.  Add  them  to  your  project: 

public  class  StarbuzzData  (  { 

public  string  Name  (  get;  set;  I 
public  Drink  FavoriteDrink  {  get;  set;  ) 
public  int  MoneySpent  {  get;  set;  ) 
public  int  Visits  (  get;  set;  } 

1 

public  enum  Drink  { 

BoringCoffee,  ChocoRockoLatte,  TripleEspresso, 

ZestyLemonChai,  DoubleCappuccino,  HalfCafAmericano, 

ChocoMacchiato,  BananaSplitlnACup, 

each  Customer  Was  bis  or  her  favorite- 

You'll  also  need  a  method  to  generate  some  sample  data: 
public  List<StarbuzzData>  GetStarbuzzData ()  { 

List<StarbuzzData>  list  =  new  List<StarbuzzData> () 
new  StarbuzzData ( )  ( 

Name  =  "Janet  Venutian",  FavoriteDrink  =  Drink. ChocoMacchiato, 
MoneySpent  =  255,  Visits  =  50  ), 
new  StarbuzzData!)  { 

Name  =  "Liz  Nelson",  FavoriteDrink  =  Drink. DoubleCappuccino, 
MoneySpent  =  150,  Visits  =  35  >, 
new  StarbuzzData!)  ( 

Name  =  "Matt  Franks",  FavoriteDrink  =  Drink. ZestyLemonChai, 
MoneySpent  =  75,  Visits  =  15  ), 
new  StarbuzzData!)  { 

Name  =  "Joe  Ng", 

MoneySpent  =  60, 
new  StarbuzzData!)  ( 

Name  =  "Sarah  Kalter",  FavoriteDrink  =  Drink. BoringCoffee, 
MoneySpent  =  110,  Visits  =  15  ) 

We  built  this  method  so  that  it  has  some  names  thatalso 
appear  m  the  Objectville  contact  list  If  you  used  different 
names,  make  sure  you’ve  y>t  matching  data  here- 


JjJ 

/■ 


The  Starbuzz  data  Comes  as  a  collection 
of  StarbuzzData  objects.  It’s  ftot  a  lot 
of  data— you  won’t  need  it  all  for  the 
promotion,  SO  you’ll  have  to  select  only  the 
data  you  need  in  the  L |N$  °^uery 


Starbuzz  has  plenty  of  yeat  drinks,  and 
N.  _ .  i _ L,c  Lie  or  hrr  favorite- 


{ 


FavoriteDrink  =  Drink. BananaSplitlnACup, 
Visits  =  10  ), 


}; 

return 


list; 
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Now  join  the  SQL  database  to  the  Starbuzz  collection 

Add  a  button  to  the  project  that  will  execute  the  query  and  display  the  results  in  the  console.  Here’s  the 
code  for  the  query: 

List<StarbuzzData>  starbuzzList  =  GetStarbuzzData ( )  ; 
ContactDBDataContext.  context  =  new  ContactDBDataContext () ; 


var  results  = 


iX  \  Wb’llneed  to  do  a  join 

to  Combine  the  Stirbuzi 


data  with  the  Customer 
data  in  the  People  table 


Here’s  where  from  starbuzzCustomer  in  starbuzzList  data  with  the  custom 
the  select  data  in  the  People  table 

new  clause  fulls  where  s tarbuzzCustomer . MoneySpent  >  90 

the  name  and  The  Peoples  memb 

company  £rom  join  person  in  da taContext .  Peoples  - in  the  DataConh 

the  database  .  ,  _  .  M  .  ..  |S  ^  Collection  th« 

andtheWite  on  starbuzzCustomer  . Name  equals  person. Name  9„es  ^  t 

Sta^b^'data  select  new  {  person. Name,  person  .Company ,  database  ^ ^ 

mto  erne  Single  ^  jfi 

starbuzzCustomer . FavoriteDrink  } ; 

result  Collection  Check  your  results-make 

and  it’s  easy  enough  to  write  to  the  console:  sure  'wo*r^s  ibe  way  you 

i  /  expect  it  to 

foreach  (var  row  in  results) {  ly 

Console . WriteLine ("{ 0 }  at  {1}  likes  {2}", 

row. Name,  row. Company,  row. FavoriteDrink) ; 


The  Peoples  member 
in  the  DataContext 
is  a  Collection  that 
gives  you  access  to  the 
People  table  in  the 
database 


m  ***  ** 

TT’S  a, 

(o“  °f  F«l  cr  «* 

make  sure  r  ,  . .  i  v 


J  Nice  work...  with  this  ^ 
new  promotion.  I'll  bet  we'll 
get  tons  of  repeat  business.  Til 
definitely  be  calling  you  again. 


Invaders 

This  lab  gives  you  a  spec  that  describes  a  program 
for  you  to  build,  using  the  knowledge  you’ve  gained 
over  the  last  few  chapters. 

This  project  is  bigger  than  the  ones  you’ve  seen  so 
far.  So  read  the  whole  thing  before  you  get  started, 
and  give  yourself  a  little  time.  And  don’t  worry  if 
you  get  stuck— there’s  nothing  new  in  here,  so  you 
can  move  on  in  the  book  and  come  back  to  the  lab 
later. 

We’ve  filled  in  a  few  design  details  for  you,  and 
we’ve  made  sure  you’ve  got  all  the  pieces  you 
need...  and  nothing  else. 

It’s  up  to  you  to  finish  the  job.  You  can  download 
an  executable  for  this  lab  from  the  website...  but 
we  won’t  give  you  the  code  for  the  answer. 


C#  Lab  681 


The  grandfather  of  video  games 

In  this  lab  you'll  pay  homage  to  one  of  the  most  popular,  revered 
and  replicated  icons  in  video  game  history,  a  game  that  needs  no 
further  introduction.  It’s  time  to  build  Invaders. 

The  invaders  attack  in  waves  of  30 


fa  the  player  destroys  the 
invaders,  the  store  goes  up. 
It's  displayed  in  the  upper 
left-hand  Corner.  \ 


I  tic.  m’ows.'  -  w w— —  - 

The  -first  wave  moves  slowly  and  fires 
a  few  shots  at  a  time  The  ne*t  wave 
moves  faster,  and  f  ires  more  shots  more 
frequently  If  all  30  invaders  in  a  wave 
are  destroyed,  the  nent  wave  attacks. 


The  player  starts  out  with  three 
ships-  The  first  ship  is  in  play, 
and  the  other  two  are  kept  in 
reserve  His  spare  ships  are  shown 
the  upper  right-hand  Corner 


1720 


<*><*}{*}<*><*}<*} 

/A\  /X\  /A\  /X\  /A\  /a\ 

V  ^  V  V  V' 


■Srf  SSf 


»  * 
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The  player  moves  the  ship  left 
and  right,  and  f  ires  shots  at 
the  invaders.  |f  a  shot  hits  an 
invader,  the  invader  is  destroyed 
and  the  player's  score  goes  up 


The  invaders  return  fire  if"* 
of  the  shots  hits  the  ship,  the 
player  loses  a  life  Once  all  Ws 
are  gone,  or  if  the  invaders 
reach  the  bottom  of  the 

screen,  the  game  ends  and  a  bg 

"6AM£  OI/ER’  *  d,s^ed  m 

I.  Jjl-  S  fbe  screen 


The  multicolored 
stars  in  the 
background  twinkle 
on  and  off,  but 
don’t  affect 
gameplay  at  all 


Invaders 


Your  mission:  defend  the  planet 
against  wave  after  wave  of  invaders 

I'lie  invaders  attack  in  waves,  where  each  wave  is  a  tight  formation 
of  30  individual  invaders.  As  the  player  destroys  invaders,  the  score 
goes  up.  The  bottom  invaders  are  shaped  like  stars  and  worth  1 0 
points.  The  spaceships  are  worth  20,  the  saucers  are  worth  30,  the 
bugs  are  worth  +0,  and  the  satellites  are  worth  50.  The  player  starts 
with  three  lives.  If  he  loses  all  three  lives  or  the  invaders  reach  the 
bottom  of  the  screen,  the  game’s  over. 


There  are  five  different  types  of  invaders, 
but  they  all  behave  the  same  way  They  start 
at  the  top  of  the  screen  and  move  left  until 
they  reach  the  edge  Then  they  drop  down 
and  start  moving  right  When  they  reach  the 
right-hand  boundary,  they  drop  down  and 
move  left  again  If  the  invaders  reach  the 
bottom  of  the  screen,  the  game’s  over. 


^  ^  (40} 


he  spacebar  shoots  But 
here  can  only  be  two 
.hots  on  the  screen  at 
5nCe  As  soon  as  a  shot  hits 

something  or  disappears, 
another  Shot  can  be  fured. 


The  f  irst  wave  of 
invaders  can  f  ire  two 
shots  at  once— the 
invaders  will  hold  their 
fire  if  there  are  more 
than  two  shots  on  the 
screen  The  ne*t  wave 
f  ires  three,  the  ne*t 
fires  four,  etc- 


If  a  shot  hits 
an  invader,  both 
disappear  Otherwise, 
the  shot  disappears 
when  it  gets  to  the 
top  of  the  screen. 


The  game  should  keep 
track  of  all  keypresses 
So  pressing  right  and 
spacebar  would  cause 
the  ship  to  move  to  the 
right  and  fire  (if  two 
shots  aren't  already  on 
the  screen) 


The  left  arrow  moves  the 
ship  towards  the  left-hand 
edge  of  the  screen 


RIGHT  -> 


The  right  arrow  key  moves 
the  ship  to  the  right 
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The  architecture  of  Invaders 

Invaders  needs  to  keep  trark  of  a  wave  of  30  invaders 
(including  their  locations,  type,  and  score  value),  the  player’s 
ship,  shots  that  the  player  and  invaders  fire  at  each  other,  and 
stars  in  the  background.  As  you  did  in  the  Quest  lab,  you'll 
need  a  Game  object  to  keep  up  w  ith  all  this,  and  coordinate 
between  the  form  and  the  game  objects. 

Here’s  an  overview  of  what  you’ll  need  to  create: 


t 


The  form  is  pretty  simple  It's  got 
timers  to  tell  the  game  to  50,  it 
passes  on  key  presses,  and  animates 
the  invaders  and  twinkling  stars  And 
it's  got  a  Paint  event  handler  to 
draw  the  graphics,  which  just  Calls 
the  djame  object’s  Draw 0  method 


The  ^ame  object  manages  the  gameplay 
It  keeps  track  of  how  many  lives  the 
player  has  left  and  how  many  waves  of 
invaders  have  attacked-  When  the  game's 
over,  it  raises  a  ^ameOver  event  to  tell 
the  form  to  stop  its  timers 


Invaders 


All  of  the  invaders  on  the  screen  are 
stored  in  a  l-ist  When  an  invader  s 
destroyed,  it's  removed  from  the  list 
SO  the  game  stops  drawing  it 


The  object  that  represents  the 
ship  keeps  track  of  its  position 
and  moves  itself  left  and  right, 
making  sure  it  doesn't  move  off 
the  side  of  the  screen- 


LisV 


The  game  keeps  two 
lists  of  Shot  objects: 
a  list  of  shots  the 
player  fired  at  the 
invaders,  and  a  list 
of  shots  the  invaders 
f  ired  back 


The  Stars  keeps  a  List  of  Star  structs  (each 
of  which  Contain  a  Point  and  a  Pen)  Stars 
also  has  a  TwinkleO  method  that  removes  five 
stars  at  random  and  adds  five  new  ones— the 
game  calls  TwinkleO  several  times  a  second  to 
make  the  stars  twinkle  in  the  background 
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design  the  Invaders  form 

The  Invaders  form  lias  only  two  controls:  a  timer  to  trigger 
animation  (making  the  stars  twinkle  and  (he  invaders  animate 
by  changing  each  invader  picture  to  a  different  frame),  and 
a  timer  to  handle  gameplay  (the  invaders  marching  left  and 
right,  die  player  moving,  and  the  player  and  invaders  shooting 
at  each  other).  Other  than  that,  the  only  intelligence  in  the 
form  is  an  event  handler  to  handle  the  game’s  GameOver 
event,  and  KeyUp  and  KeyDown  event  handlers  to  manage 
the  keyboard  input. 


The  form  -fires  a  KeyDown  event  any 
time  a  key  is  pressed,  and  it  fires  a 
KeyUp  event  whenever  a  key  is  released 


When  the  form  ,nitializ<s  its  $a.ne  object, 
.t  passes  ,ts  DisplayRectanjIe  to  it  so  it 

(  knows  the  ^ar.es  of  the  form.  So  you 

I  ttn  change  the  si«  of  the  battlef .eld 
just  by  changing  the  si«  of  the  form. 


V 


Forml  rorml.cs  [Design]  stars.cs  Invader.es  PlayerShp.es  6ame.es 


*  Invaders 


▼  X 


■ 


0  animadonTlmer  0  gameTlmer 


You  should  add  two  timers’ 
animationTimer  and  gameTimer. 


Set  the  form’s  Form&orderStyle  property  to  F.«dSingle,  -ts 
DoubleBuffered  property  to  true  turn  off  m.m.reBo 

and  Mart m.zeBo*  properties,  set  its  title,  and  then  stretc_ 
it  out  to  the  width  you  want  the  game  area  to  be 
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Invaders 


The  animation  timer  handles  the  eye  candy 

The  stars  in  the  game’s  background  and  the  invader  animation 
don’t  affect  gameplay,  and  they  continue  when  the  game  is 
paused  or  stopped.  So  we  need  a  separate  timer  for  those. 


Add  code  for  the  animation  timer's  tick  event 

Your  code  should  have  a  counter  that  cycles  from  0  to  It  and  then  back  down 
to  0.  That  counter  is  used  to  update  each  of  the  four-cell  invader  animations 
(creating  a  smooth  animation).  Your  handler  should  also  call  the  Game 
object’s  Twinkle  ()  method,  which  will  cause  the  stars  to  twinkle.  Finally,  it 
needs  to  call  the  form’s  Refresh  ( )  method  to  repaint  the  screen. 

Try  a  timer  interval  of  33ms,  which  will  give  you  about  30  frames  per  second. 
Make  sure  you  set  the  game  timer  to  a  shorter  interval,  though.  The  ship 
should  move  and  gameplay  should  occur  more  quickly  than  the  stars  twinkle. 


<**urs  even 
-T*"  9a"*play  doesn't. 
7 **  tkat  the 
w"*We  and  the 
??***  even  if 

i  ken  started 


Adjust  the  timer  for  smooth  animation 


With  a  33ms  interval  for  animation,  set  the  game  timer  to  10ms.  That  way,  the 
main  gameplay  "  ill  occur  more  quickly  than  the  animation  (which  is  really  just 
background  eye  candy).  At  the  same  time,  the  Go  ( )  method  in  Game  (fired 
by  the  game  timer,  which  we’ll  talk  about  in  a  little  bit)  can  take  a  lot  of  CPU 
cycles.  If  the  CPU  is  busy  handling  gameplay,  the  animation  timer  will  just  wait 
until  die  CPU  gets  to  it,  and  then  fire  (and  animate  the  stars  and  invaders). 

set  to  ?3ms,  but  the  £jame 

Alternately,  you  can  just  set  both  timers  to  an  interval  of  5nts,  and  the  game  object’s  6jo0  method  takes 

will  run  and  animate  about  as  fast  as  your  system  can  handle  (although  on  fast  longer  than  that  to  run, 

machines,  animation  could  get  annoyingly  quick).  then  animation  will  odd ur 

onde  ^o0  Completes. 


An  invader  starts  with  Cell  O, 


T 

We  tried  things  out  on  a  slow  machine, 
and  -Pound  that  setting  the  animation 
interval  to  100ms  and  the  gameplay  timer 
interval  to  50ms  gave  us  a  -Frame  rate  oF 
about  lo  Frames  per  second,  which  was 
deFimtely  playable  Try  starting  there  and 
reducing  each  interval  until  you’re  happy 
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Respond  to  keyboard  input 

Before  we  can  code  the  game  timer,  we  need  to  write  event 
handlers  for  the  KeyDown  and  KeyUp  events.  KeyDown  is 
triggered  when  a  key  is  pressed,  and  KeyUp  when  a  key  is 
released.  For  most  keys,  we  can  simply  take  action,  by  firing  a 
shot  or  quitting  the  game. 

For  some  keys,  like  the  right  or  left  arrow,  we  want  to  store  those 
in  a  list  that  our  game  timer  can  then  use  to  move  the  player’s  ^ 
ship.  So  we’ll  also  need  a  list  of  pressed  keys  in  the  form  object: 


List<Keys>  keysPressed  =  new  List<Keys> ( ) ; 


So  if  Jke  player's  hold.nj  down 
the  left  arrow  and  spade  bar  at 
ibe  same  time,  the  list  will  Contain 

^eys  Le+t  and  KeysSpace 

We  need  a  list  of  keys  so  we  tan 
tratk  which  keys  have  been  pressed 

- Our  jame  timer  will  need  that  list 

for  movement  in  j“st  a  bit 


private  void  Forml  KeyDown (object  sender,  KeyEventArgs  e)  { 
if  (e.KeyCode  ==  Keys . Q)  , 

Application  .Eb^t  ()  ;  ^  ^  ^ey  3ame 


The  Rey: 

enum 

defines  all 
the  keys 
you  mijht 
want  to 


Keys.S)  { 


If  the  ^ame  has  ended,  reset 
the  jame  and  start  over 


if  (gameOver) 

if  (e.KeyCode  _ 

//  code  to  reset  the  game  and  restart  the  timers 

return; 


But  we  only  want  this  to  work 
if  the  game's  over  Pressing  S  ^ 
shouldn't  restart  a  yme  that  S 
already  in  progress 


=  Keys . Space) 


check  key  if  (e.KeyCode 
t  eS  game .  FireShot  ( )  ; 

if  (keysPressed. Contains (e.KeyCode) ) 
keysPressed . Remove (e . KeyCode ) 
keysPressed. Add  (e.KeyCode),; 

The  key  that's  pressed  jets  added  to 
our  key  list,  which  we  ll  use  in  a  second 


^  You  II  need  to  fill  in  this  Code 
^  The  spacebar  f  ires  a  shot 


ajainst 


} 


ycoaej ) 

S)  By  removing  the  key  and  then re-addmj 

it;  it  makes  the  key  the  last  (most  fs 
Current)  item  in  the  list  \ 


private  void  Forml_KeyUp (object  sender,  KeyEventArgs  e)  { 
if  (keysPressed. Contains (e.KeyCode) ) 
keysPressed. Remove (e.KeyCode) ; 


a  ke/Js  we  remove  it 

1  W  of  pressed  keys. 


We  want  the  most 
Current  key  pressed  to  be 
at  the  very  top  of  the 
list,  so  that  if  the  player 
mashes  a  few  keys  at 
the  same  time,  the  jame 
responds  to  the  one  that 
hit  most  recently  Then, 
when  he  lets  up  one  key, 
the  J3rne  responds  to  the 
ne*t  one  in  the  list 
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Invaders 


The  game  timer  handles  movement  and  gameplay 

The  main  job  of  the  form’s  game  timer  is  to  rail  Go  ( )  in  the 
Game  class.  But  it  also  has  to  respond  to  any  keys  pressed,  so  it 
has  to  check  the  keysPressed  list  to  find  any  keys  caught  by  the 
Key  Down  and  KeyUp  events: 

Make  sure  Y0'*'r  r'a,"m3  m^tekes  up  with 
whdt  you  tall  Your  hauler  methods 


private  void  gameTimerTick (object  sender,  EventArgs  e)  { 


0  gameTimer 


I 


if  (keysPressed. Count ()  >=  1)  { 
switch  (keysPressed f 01 )  ( 
case  Keys. Left: 

game.MovePlayer (Direction. Left) ; 
break; 

case  Keys. Right:  ^ 

game.MovePlayer (Direction .Right)  , 
break; 

)  _ We  only  need  to  deal  with 

)  movement  Other  keys,  like 

game . Go ( ) ; 


spacebar,  and  Q'  (or  c^uit,  are 
handled  in  the  KeyDowh 0 
method  you  just  wrote 


keysPressed  is  your 

ob  ett  managed  by  the  ^eypown 

and  KeyUp  event  handlers  The 
key  at  inde*  zero  will  always  be 

the  most  retent  key  pressed 

The  KeyMp  and  KeyDown 
events  use  the  Keys  enum 
to  syeti-fy  a  key  We’ll  use 
KeysLe-ft  and  Keys  Right 
to  move  the  ship 


Finally)  we  tall  &()  on  the  ^ame 
object  to  let  same  play  Continue 

Shots  move  up  and  down,  the  player  moves  le-Pt  ^ 
and  right,  and  the  invaders  move  le-ft,  right, 
and  down  ybu’ll  need  this  enum  to  keep  all 
those  directions  straight 

One  wore  form  detail:  the  (raweOver  event 


Add  a  private  bool  field  called  gameOver  to  the  form  that’s  true  only  ^ _ 

when  the  game  is  over.  Then  add  an  event  handler  for  the  Game  object’s 
GameOver  event  that  stops  the  game  timer  (but  not  the  animation  timer,  so 
tile  stars  still  twinkle  and  the  invaders  still  animate),  sets  gameOver  to  true, 
and  calls  the  form’s  Refresh  ( )  method. 

When  you  write  the  form’s  Paint  event  handler,  have  it  check  gameOver. 

If  it’s  true,  have  it  write  GAME  Q\TR  in  big  yellow  letters  in  the  middle  of 
the  screen.  Then  have  it  write  “Press  S  to  start  a  new  game  or  Qto  quit"  in 
the  lower  right-hand  corner. 


public  enum  Direction 
Left, 

Right, 

Up, 

Down, 

} 


all  manual  coding 


\ 


Tfce  name  over  event  and  «ts 

aeleSte  l,«e  *  **  *** 
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The  form's  game  timer  tells  the  game  to  (roll 

In  addition  to  handling  movement  left  and  right,  the  main  job  of  the  game 
timer  is  to  call  the  Game  object’s  Go  ( )  method.  That’s  where  all  of  the 
ganieplav  is  managed.  The  Game  object  keeps  track  of  the  state  of  the  game, 
and  its  Go  ( )  method  advances  the  game  by  one  frame.  That  involves: 


o 


Checking  to  see  if  the  player  died,  using  its  Alive  property.  When  the  player  dies, 
the  game  shows  a  little  animation  of  the  ship  collapsing  (using  Drawlmage  ( )  to  squish 
the  ship  down  to  nothing).  The  animation  is  done  by  the  PlayerShip  class,  so  Go  ( )  just 
needs  to  check  to  see  if  it’s  dead.  If  it  is,  it  returns — that  way,  it  keeps  the  invaders  from 
moving  or  shooting  while  the  player  gets  a  small  break  (and  watches  his  ship  get  crushed). 


o 


Moving  each  of  the  shots.  Shots  fired  by  the  invaders  move  down,  and  shots  fired  by  the 
player  move  up.  Game  keeps  two  List<Shot>  objects,  one  for  the  invaders’  shots  and  one 
for  the  player’s.  Any  shot  that’s  moved  off  the  screen  needs  to  be  removed  from  the  list. 


o 


Moving  each  of  the  invaders.  Game  calls  each  Invader  object’s  Move  ( )  method, 
and  tells  the  invaders  which  way  to  move.  Game  also  keeps  up  with  where  the  invaders  are 
in  case  they  need  to  move  down  a  row  or  switch  directions.  Then,  Game  checks  to  see  if  it’s 
time  for  the  invaders  to  return  fire,  and  if  so,  it  adds  new  Shot  objects  to  the  ListO. 


o 


Checking  for  hits.  If  a  player’s  shot  hit  any  invaders,  Game  removes  the  invaders  from  the 
appropriate  Listo.  Then  Game  checks  to  see  if  any  of  the  invader  shots  have  collided  with 
the  player’s  ship,  and  if  so,  it  kills  the  player  by  setting  its  Alive  property  to  false.  If  the 


player’s  out  of  lives,  then  Game  raises  the  GameOver  event  to  tell  the  form  that  the  game’s  _ 
over.  The  form’s  GameOver  event  handler  stops  its  game  timer,  so  Go  ( )  isn’t  called  again. 

Here’s  where  that 


0  gameTimer 


The  <ya»e  -timer  fires  more  often 
than  the  animation  timer,  making 
gameplay  happen  <\uitkly. 
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Taking  control  of  graphics 

In  earlier  labs,  the  form  used  controls  for  the  graphics.  But  now 
that  you  know  how  to  use  Graphics  and  double-buffering,  the 
Game  object  should  handle  a  lot  of  the  drawing. 

So  the  form  should  have  a  Paint  event  handler  (which  you'll 
put  your  double-buffering  inside).  But  you’ll  delegate  the  rest  of 
the  drawing  to  the  Game  object  ever)'  lime  that  event  fires. 


Everything  that  happens  visually 
in  the  game  happens  in  the 
■form'  s  Paint  event  handler 


fires 


^Iir  nrawlq,  animat:i0n^^ 

The  invaders  have  a  four-cell 
animation  sequence,  so  the 
^  -form  passes  an  int  telling  the 
game  which  Cell  to  draw 


The  game  tells  each 
invader  which  Cell  to 
draw  based  on  the 


r  animationCell  passed 
stars .  Draw  (g)  ;  by  the  form 

The  ^ame  object’s  DrawO  method  foreach  ( Invader ^rfvader  in  invaders) 

calls  the  DrawO  methods  on  all  of  invader .  Dr aw@"  animationCell)  ; 

the  other  objects.  You’ll  see  how  playerShip.  Draw  (g)  ; 

each  of  the  other  classes’  DrawO  foreach  (Shot  shot  in  playerShots) 

methods  work  in  the  ne*t  few  pages.  shot .  Draw  (g)  ; 

foreach  (Shot  shot  in  invaderShots ) 
shot. Draw (g) ; 
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Building  the  frame  class 


The  Game  class  is  the  controller  for  the  Invaders  game.  Here’s  a 
start  on  what  this  class  should  look  like,  although  there’s  lots  of 
work  still  for  you  to  do. 

The  s tort,  livesLeft,  and  wave  -fields 
public  class  Game  {  /  brack  of  some  basic  information 

int  score  =  0;  / 

int  livesLeft  =2; 


private 

private 

private 

private 


game 


private 

private 

private 

private 

private 

private 

private 


int  wave  0;  J  ^  You’ll  use  the  frame  field  to  slow  down  the 

int  framesSkipped  =  0;  *^T  invaders  early  on  in  the  ^ame— the  f  irst  wave 

should  skip  h  frames  before  they  move  to  the 
left,  the  nest  wave  should  skip  5,  the  nest 
should  skip  etc 

This  List<>  of  Invader  objects  keeps  track  of  all  of 
the  invaders  in  the  Current  wave  When  an  invader  is 
destroyed,  it's  removed  from  the  list-  The  <jame  checks 
periodically  to  make  sure  the  list  isn’t  empty— if 't  is,  it 
sends  in  the  nest  wave  of  invaders 


Rectangle  boundaries; 

Random  random; 

Direction  invaderDirection; 
List<Invader>  invaders; 


PlayerShip  playerShip; 
List<Shot>  playerShots; 
List<Shot>  invaderShots; 


private  Stars  stars; 


This  Stars  object  keeps  track  of  the 
multicolored  stars  in  the  background 


public  event  EventHandler  GameOver; 
//  etc . . . 


The  ^ame  object  raises  its  ^ameOver 
event  when  the  player  dies  and  doesn’t 
have  any  more  lives  left  You’ll  build 
the  event  handler  method  in  the  form, 
and  hook  it  into  the  djame  object’s 
^ameOver  event 


Most  of  these 

methods  Combine 
methods  on  other 
objects  to  make  a 
specif  ic  action  occur 


Game 


GameOver:  event 


Draw(g:  Graphics,  animationCell:  int)  | 
Twinkle() 

MovePlayer(direction:  Direction) 
FireShotO 
Go() 


Remember,  these  are  the 
public  methods.  y4u  may  need 
a  lot  more  private  methods  to 
structure  your  Code  in  a  way 
that  makes  sense  to  you 
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The  6-awe  class  methods 

The  Game  class  has  five  public  methods  that  get  triggered 
by  different  events  happening  in  the  form. 

Q  The  Draw()  method  draws  the  game  on  a  graphics  object 

The  Draw  ( )  method  takes  two  parameters:  a  Graphics  object  and  an  integer  that  contains 
the  animation  cell  (a  number  from  0  to  3).  First,  it  should  draw  a  black  rectangle  that  fills  up 
the  whole  form  (using  the  display  rectangle  stored  in  boundaries,  received  from  the  form). 
Then  the  method  should  draw  the  stars,  the  invaders,  then  the  player’s  ship,  and  then  the 
shots.  Finally,  it  should  draw  the  score  in  the  upper  left-hand  corner,  the  player’s  ships  in  the 
upper  right-hand  corner,  and  a  big  “GAME  OVER”  in  yellow  letters  if  gameOver  is  true. 

The  Twinkle()  method  twinkles  the  stars 

The  form’s  animation  timer  event  handler  needs  to  be  able  to  twinkle  the  stars,  so  the  Game 

object  needs  a  one-line  method  to  call  stars .  Twinkle  () .  r 

* _ We'll  wri it  code  for  the  Stars 

obiect  is  a  few  more  ^a^cs- 

The  MovePlayer()  method  moves  the  player 

The  form's  keyboard  timer  event  handler  needs  to  move  the  player's  ship,  so  the  Game  object 
also  needs  a  two-line  method  that  takes  a  Direction  enum  as  a  parameter,  checks  whether 
or  not  the  player’s  dead,  and  calls  player  Ship .  Move  ( )  to  affect  that  movement. 

The  FireShot()  method  makes  the  player  fire  a  shot  at  the  invaders 

The  FireShot  ( )  method  checks  to  see  if  there  are  fewer  than  two  player  shots  on  screen.  If 
there  are,  the  method  should  add  a  new  shot  to  the  playerShots  list  at  the  right  location. 

The  Go()  method  makes  the  game  go 

The  form's  animation  timer  calls  (he  Game  object’s  Go  ( )  method  anywhere  between  10 
and  30  times  a  second  (depending  on  the  computer’s  GPU  speed).  The  Go  ( )  method  does 
everything  the  game  needs  to  do  to  advance  itself  by  a  frame: 

*  The  game  checks  if  the  player’s  dead  using  its  Alive  property.  If  he’s  still  alive,  the 
game  isn't  ox  er  yet — if  it  were,  the  form  would  have  stopped  the  animation  timer  with 
its  Stop  ( )  method.  So  the  Go  ( )  method  won’t  do  anything  else  until  the  ship’s  alive 
again  it'll  just  return. 

*  Every  shot  needs  to  lx-  updated.  The  game  needs  to  loop  through  both  List<Shot> 
objects,  calling  each  shot’s  Move  ( )  method.  If  any  shot’s  Move  ( )  returns  false,  that 
means  die  shot  went  off  the  edge  of  the  screen — so  it  gets  deleted  from  the  list. 

*  The  game  then  moves  each  invader,  and  allows  them  to  return  fire. 

*  Finally,  it  checks  for  collisions:  first  for  any  shot  that  overlaps  an  invader  (and  removing 
both  from  their  Listos),  and  then  to  see  if  the  player’s  been  shot.  We'll  add  a 
Rectangle  property  called  Area  to  die  Invader  and  PlayerShip  classes — so  we 
can  use  the  Contains  ( )  method  to  see  if  the  ships'  area  overlaps  with  a  shot. 
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Filling  out  the  frame  class 

I  'lie  problem  with  class  diagrams  is  that  they  usually  leave  out 
any  non-public  properties  and  methods.  So  even  after  you've 
got  the  methods  from  page  693  done,  you've  still  got  a  lot  of 
work  to  do.  Here  are  some  things  to  think  about: 


The  constructor  sets  everything  up 

Tiie  Game  object  needs  to  create  all  of  the  other  objects  the  Invader 

objects,  the  PlayerShip  object,  the  List  objects  to  hold  the  shots,  and  the  _ ^ 

Stars  object.  The  form  passes  in  an  initialized  Random  object  and  its  own  \ 

DisplayRectangle  struct  (so  the  Game  can  figure  out  the  boundaries  vVc’ll  ■talk  about  »ost  or  these 

of  the  battlefield,  which  it  uses  to  determine  when  shots  are  out  of  range  and  individual  objects  over  the  nest 

when  the  invaders  reached  the  edge  and  need  to  drop  and  reverse  direction).  Then,  several  pages  of  this  lab 
your  code  should  create  everything  else  in  the  game  world. 


Puild  a  NextWaveO  method 

A  simple  method  to  create  die  next  wave  of  invaders  will  come  in  handy.  It  should 
assign  a  new  List  of  Invader  objects  to  the  invaders  field,  add  the  30  invaders 
in  6  columns  so  that  they’re  in  their  starting  positions,  increase  the  wave  field  by  1, 
and  set  the  invaderDirection  field  to  start  them  moving  towards  the  right- 
hand  side  of  the  screen.  You’D  also  change  the  f  ramesSkipped  field. 

Here  s  an  example  of  3  private 

A  few  other  ideas  for  private  methods  wil1  rea,|y  Ke|p  «*t 

your  qarne  class  organisation 

Here  arc  a  few  of  the  private  method  ideas  you  might  play  with,  and  see  if  these 
would  also  help  the  design  of  your  Game  class: 


✓A  method  to  see  if  the  player's  been  hit  (CheckForPlayerCollisions  ( )) 

S  A  method  to  see  if  any  invaders  have  been  hit  (CheckForlnvaderCollisions  ( ) ) 
S  A  method  to  move  aU  the  invaders  (Move  Invaders  ( ) ) 

S  A  method  allowing  invaders  to  return  fire  (ReturnFire  ( ) ) 


It’s  possible  to  show  protected  and  private  properties 
and  methods  on  a  class  diagram,  but  you’ll  rarely  see 
that  put  into  practice.  Why  do  you  think  that  is? 
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UNQ  wakes  collision  detection  much  easier 

You’ve  got  collections  of  invaders  and  shots,  and  you  need  to  search  through  those 
collections  to  find  certain  invaders  and  shots.  Anytime  you  hear  collections  and 
searching  in  the  same  sentence,  you  should  think  LINQ  Here’s  what  you  need  to  do: 


This  stews  really  complex 
wken  you  first  read  it, 
but  each  ^uery  is 

just  3  Couple  of  lines  of 
code  Here's  a  hint  don't 

overcomplicate  it/ 


o 


Figure  out  if  the  invaders'  formation  has  reached  the  edge  of  the  battlefield 

The  invaders  need  to  change  direction  if  any  one  invader  is  within  10U  pixels  of  the  edge  of  the  battlefield. 
When  the  invaders  are  marching  to  the  right,  once  they  reach  the  right-hand  side  of  the  form  the  game 
needs  to  tell  them  to  drop  down  and  start  marching  to  the  left.  And  when  the  invaders  are  marching  to 
the  left,  the  game  needs  to  check  if  they’ve  reached  the  left  edge.  To  make  this  happen,  add  a  private 
Movelnvaders  ( )  method  that  gels  called  by  Go  ( )  .The  first  thing  it  should  do  is  check  and  update  the 
private  f  ramesSkipped  field,  and  return  if  this  frame  should  be  skipped  (depending  on  the  level). 
Then  it  should  check  which  direction  the  invaders  are  moving.  If  the  invaders  are  moving  to  the  right, 
Movelnvaders  ( )  should  use  LINQ,  to  search  the  invaderCollection  list  for  any  invader  whose 
location’s  X  value  is  within  100  pixels  of  the  right-hand  boundary.  If  it  finds  any,  then  it  should  tell  the 
invaders  to  march  downwards  and  then  set  invaderDirection  equal  to  Direction.  Left;  if  not,  it 
can  tell  each  invader  to  march  to  the  right.  On  the  other  hand,  if  the  invaders  are  moving  to  the  left,  then 
it  should  do  the  opposite,  using  another  LINQ  query  to  see  if  the  invaders  are  within  100  pixels  of  the 
left-hand  boundary,  marching  them  down  and  changing  direction  if  they  are. 


Determine  which  invaders  can  return  fire 

Add  a  private  method  called  ReturnFire  ( )  that  gels 
called  by  Go  () .  First,  it  should  return  if  the  invaders’ 
shot  list  already  has  wave  +  1  shots.  It  should  also 
return  if  random. Next  (10)  <  10  -  wave. 

(That  makes  the  invaders  fire  at  random,  and  not  all 
the  time.)  If  it  gets  past  both  tests,  it  can  use  LINQto 
group  the  invaders  by  their  Location .  X  and  sort  them 
descending.  Once  it’s  got  those  groups,  it  can  choose 
a  group  at  random,  and  use  its  First  ( )  method  to 
find  the  invader  at  the  bottom  of  the  column.  All  right, 
now  you’ve  got  the  shooter  you  can  add  a  shot  to  the 
invader’s  shot  list  just  below  the  middle  of  the  invader 
(use  the  invader’s  Area  to  set  the  shot's  location). 

Check  for  invader  and  player  collisions 

You'll  want  to  create  a  method  to  check  for  collisions.  There  are  three  collisions  to  check  for,  and  the 
Rectangle  struct’s  Contains  ( )  method  will  come  in  really  handy  just  pass  it  any  Point,  and  it’ll  return 
true  if  that  point  is  inside  the  rectangle. 

★  Use  IJNQto  find  any  dead  invaders  by  looping  through  the  shots  in  the  player’s  shot  list  and  selecting 
any  invader  where  invader .  Area  contains  the  shot’s  location.  Remove  the  invader  and  the  shot. 

★  Add  a  query  to  figure  out  if  any  invaders  reached  the  bottom  of  the  screen  if  so,  end  the  game. 

★  You  don't  need  UNQ  to  look  for  shots  that  collided  with  the  player,  just  a  loop  and  the  player’s  Area 
property.  (Remember,  you  can’t  modify  a  collection  inside  a  foreach  loop.  If  you  do,  you'll  get 
an  InvalidOperalionException  with  a  message  that  the  collection  was  modified.) 
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Crafting  the  Invader  class 

The  Invader  class  keeps  track  of  a  single  invader.  So  when  the  Game 
object  creates  a  new  wave  of  invaders,  it  adds  30  instances  of  Invader  to 
a  List<Invader>  object.  Every  time  its  Go  ()  method  is  called,  it  calls 
each  invader’s  Move  ( )  method  to  tell  it  to  move.  And  every  time  its  Draw  ( ) 
method  is  called,  it  calls  each  invader  object’s  Draw  ( )  method.  So  you’ll 
need  to  build  out  the  Move  ( )  and  Draw  ( )  methods.  And  you’ll  want  to  add 
a  private  method  called  Invader  Image  ( )  too — it'll  come  in  really  handy 
when  you’re  drawing  the  invader.  Make  sure  you  call  it  inside  the  Draw  ( ) 
method  to  keep  the  image  field  up  to  date: 


public  class  Invader  ( 

private  const  int  Horizontallnterval  = 
private  const  int  Verticallnterval  =  40 
public  enum  Type  { 

Bug, 

Saucer, 

Satellite, 

Spaceship, 

Star, 

} 


D0  { 

The  invader  uses  the  Type 
^  enum  -to  figure  out  what  kind 
of  enemy  ship  it  is. 


private  Bitmap  image; 
public  Point  Location  { 
public  Type  InvaderType 


get;  private  set;  } 
{  get;  private  set; 


public  Rectangle  Area  (  get  { 

return  new  Rectangle (location,  image. Size) 


public  int  Score  {  get;  private  set;  } 


The  Horizontal  I  ntewal  Constant 
determines  how  many  pixels  an  invader 
moves  every  time  it  marches  left  or 
right-  Verticallnterval  is  the  number  of 
pixels  it  drops  down  when  the  formation 
reaches  the  edge  of  the  battlef  ield 


Check  out  what  we  did 
with  the  Area  property 
SinCe  we  know  the  invader  s 
location  and  we  know  its 
size  (-from  its  image  field), 
we  can  add  a  get  accessor 
that  calculates  a  Rectangle 
for  the  area  it  Covers 
which  means  you  can  use 
the  Rectangle’s  Contains!) 
method  inside  a  UN#  guery 
to  detect  any  shots  that 
Collided  with  an  invader 


public  Invader (Type  invaderType,  Point  location,  int  score)  { 
this . InvaderType  =  invaderType; 
this . Location  =  location; 
this. Score  =  score; 
image  =  Invaderlmage (0) ; 


//  Additional  methods  will  go  here 


Invader 


Location:  Point 
InvaderType:  Type 
Area:  Rectangle 
Score:  int 


Draw(g:  Graphics,  animationCell:  int) 
Move(direction:  Direction) 
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There  are  -five  types  of  invaders, 
and  eath  of  them  has  -four 
different  animation  dell  pictures. 

i 


h  irst,  you  need  a  method  to  move  the  invader  ships.  The  Game  object  should 
send  in  a  direction,  using  the  Direction  enum,  and  then  the  ship  should 
move.  Remember,  the  Game  object  handles  figuring  out  ii'  an  invader  needs  to 
move  down  or  change  direction,  so  your  Invader  class  doesn’t  have  to  worry 
about  that. 

public  void  Move (Direction  direction)  { 

//  This  method  needs  to  move  the  ship  in  the 
//  specified  direction 

> 


Praw  the  ship  -  and  the  right  animation  cell 

Each  Invader  knows  how  to  draw  itself.  Given  a  Graphics  object  to  draw 
to,  and  the  animation  cell  to  use,  the  invader  ran  display  itself  onto  the  game 
board  using  the  Graphics  object  the  Game  gives  it. 

public  void  Draw (Graphics  g,  int  animationCell)  { 
//  This  method  needs  to  draw  the  image  of 
//  the  ship,  using  the  correct  animation  cell 

} 


Build  the  Invaders'  methods 

The  three  core  methods  for  Invader  are  Move  ( ) ,  Draw  ( ) ,  and 
Invaderlmage  ( ) .  Let’s  look  at  each  in  turn: 

Move  the  invader  ships 


fret  the  right  Invader  image 


You’re  going  to  need  to  grab  the  right  image  based  on  the  animation 
cell  a  lot,  so  you  may  want  to  pull  dial  code  into  its  own  method. 

Build  an  Invaderlmage  ( )  method  that  returns  a  specific  Bitmap 
given  an  animation  cell. 


private  Bitmap  Invaderlmage (int  animationCell)  { 

//  This  is  mostly  a  convenience  method,  and 
//  returns  the  right  bitmap  for  the  specified  cell 

} 


Each  invader  knows  its 
type  So  if  you  give  its 
|nvader|mageO  method  a 
number  for  its  animation 
dell,  it  dan  return  a 
Bitmap  that’s  got  the 
right  graphic  in  it. 
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The  player's  ship  can  move  and  die 

The  PlayerShip  class  keeps  track  of  the 
player’s  ship.  It’s  similar  to  the  Invaders  class,  but 
even  simpler. 

The  Location  and  Avea 
properties  are  exactly  like 
the  ones  in  the  Invader  class. 


PlayerShip 

5  Location:  Point 
(  Area:  Rectangle 
Alive:  bool 


The  DrawO  method  just  draws 
the  player's  ship  in  the  right 
location-unless  the  player 
died,  in  which  case  it  draws  an 
animation  of  the  ship  getting 
Crushed  by  the  shot 


Draw(g:  Graphics) 
Move(direction:  Direction )eA 


When  the  ship's  hit  with  a  shot, 
the  game  sets  the  ship's  Alive 
property  to  false  The  game 
then  keeps  the  invaders  fr  Orn 
moving  until  the  ship  resets  its 
Alive  property  back  to  true 


The  MoveO  method  takes 
one  parameter,  a  Direction 
enum,  and  moves  the  player 
in  that  direction 


Animate  the  player  ship  when  it's  hit 


PlayerShip  needs  to  take 
in  a  Rectangle  with  the 
game  s  boundaries  in  its 
Constructor,  and  make 
sure  the  ship  doesn't  get 
moved  out  of  the  game's 
boundaries  in  /VloveO. 


The  Draw  ()  method  should  take  a  Graphics  object  as  a  parameter.  Then  it  checks 
its  Alive  property.  If  it’s  alive,  it  draws  itself  using  its  Location  property.  If  it’s 
dead,  then  instead  of  drawing  the  regular  bitmap  on  the  graphics,  the  PlayerShip 
object  uses  its  private  deadShipHeight  field  to  animate  the  player  ship  slowly 
getting  crushed  by  the  shot.  After  three  seconds  of  being  dead,  it  should  Hip  its  Alive 
property  back  to  true. 

A  Waiting  three  seconds  is  easy-just  use  the  Alive  property's  set  accessor  to  set 
a  private  DateTime  field  to  DateTime .  Now  The  first  thing  the  ship's  <$o0 
I  method  does  is  use  a  TimeSpan  to  check  if  three  seconds  have  elapsed  if  three 
seconds  haven't  elapsed,  Continue  doing  the  Crushing  ship  animation  As  soon  as 
three  seconds  have  elapsed,  set  Alive  back  to  true  so  the  game  knows  it  should 
Continue  gameplay  (You  used  a  similar  trick  in  the  beehive  simulator ) 


public  void  Draw (Graphics  g)  { 
if  ( ! Alive)  { 

Reset  the  deadShipHeight  field  and  draw  the  ship. 

}  else  ( 

Check  the  deadShipHeight  field.  If  it's  greater  than  zero,  decrease  it  by  1 
and  use  DrazvhnageQ  to  draw  the  ship  a  little  flatter. 


1 


) 
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"Shots  fired!" 

Game  lias  two  lists  of  Shot  objects:  one  lor  the  player’s  shots,  moving 
up  the  screen,  and  one  for  enemy  shots,  moving  down  the  screen. 

Shot  only  needs  a  few  things  to  work:  a  Point  location,  a  method  to 
draw  die  shot,  and  a  niediod  to  move.  Here's  die  class  diagram: 


DrawO  handles  drawing  -the  little  rectangle 
■for  this  shot  6jame  will  call  this  every  time 
the  screen  needs  to  be  updated 

MoveO  moves  the  shot  up 
or  down,  and  keeps  up  with 
whether  the  shot  is  within  the 
game's  boundaries 

Here’s  a  start  on  the  Shot  class: 


public  class  Shot  { 

private  const  int  movelnterval 
private  const  int  width  =  5; 
private  const  int  height  =  15; 


You  can  adjust  these  to  make  the  game 
easier  or  harder,  smaller  shots  are  easier 
to  dodge,  faster  shots  are  harder  to  avoid 


public  Point  Location  {  get;  private  set;  }  The  shot  updates  its  own  location  in 

i  the  MoveO  method,  SO  location  can 
private  Direction  direction;  he  a  read-only  automatic  property 

private  Rectangle  boundaries; 

Direction  is  the  enum  with  Up 

public  Shot  (Point  location,  Direction  direction,  and  Down  defined  r 

Rectangle  boundaries)  {  - r  _ —  < — . 


this. Location  =  location; 
this . direction  =  direction; 
this .boundaries  =  boundaries; 


The  game  passes  the  form’s  display  rectangle 
into  the  Constructor’s  boundaries  parameter  so 
the  shot  can  tell  when  it’s  off  of  the  screen 


//  Your  code  goes  here 


Your  job  is  to  make  sure  Draw  ( )  takes  in  a  Graphics  object 
and  draws  the  shot  as  a  yellow  rectangle.  Then,  Move  ( )  should 
move  the  shot  up  or  down,  and  return  true  if  the  shot  is  still 
within  the  game  boundaries. 
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Twinkle,  twinkle...  it's  up  to  you 

I  he  last  class  you'll  need  is  the  Stars  class.  There  are  300  stars,  and  this  class 
keeps  up  with  all  of  them,  causing  5  to  display  and  5  to  disappear  every  time 
Twinkled  is  called . 

First,  though,  you'll  need  a  struct  for  each  star: 
private  struct  Star  { 

public  Point  point;  ^  has  a  point  (its  location) 

public  Pen  pen;  ^  a  f*"  (W  CoUr) 


Here’s  another  hint  start  out 
the  project  with  jwt  a  -form, 
a  lja»>e  class  and  Stars  class. 
See  if  you  can  get  it  to  draw 
a  black  sky  with  twinkling 
stars  That’ll  give  you  a  solid 
foundation  to  add  the  other 
classes  and  methods 


public  Star (Point  point,  Pen  pen)  { 
this. point  =  point;  <r\ 

this. pen  =  pen;  ^  V,  star  does  is  hold  this 

1  data  no  behavior 


The  Stars  class  should  keep  a  List<Star>  for  storing  300  of  these  Star 
structs.  You'll  need  to  build  a  constructor  for  Stars  that  populates  dial 
list.  The  constructor  will  get  a  Rectangle  with  the  display  boundaries,  and 
a  Random  instance  lor  use  in  creating  the  random  Points  to  place  each  star  in 
a  random  location. 

Here’s  the  class  diagram  for  Stars,  w  ith  the  other  methods  you’ll  need: 


ybu  can  def  ine  the  Star 

Stars  needs  tpvse  that  struct 


prawO  draws  all 
WO  stars  ..  . 


••  and  TwinkleO 
pulls  5  stars  and 
adds  5  new  ones. 


_ Stars _ 

Draw(g:  Graphics) 

*=- 

Twinkle( random:  Random) 


‘  "<Jintains  an 
j^nCe  of  Random 

that  all  the  objects 
can  use 


Draw  ( )  should  draw  all  the  stars  in  the  list,  and  Twinkle  ( )  should 
remove  five  random  stars  and  add  five  new  stars  in  their  place. 

You  might  also  want  to  create  a  RandomPen  ( )  method  so  you  can 
get  a  random  color  for  the  stars  every  time  you  create  a  new  star  easily. 
It  should  return  one  of  the  five  colors  stars  come  in,  by  generating  a 
number  between  0  and  4,  and  selecting  the  matching  Pen  object. 
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And  yet  there's  wore  to  do... 

Think  the  game’s  looking  pretty  good?  You  ran  take  it  to  the 
next  level  with  a  few  more  additions: 


Add  animated  explosions 

Make  each  invader  explode  after  it’s  hit,  then  briefly  display  a  number  to 
tell  the  player  how  many  points  the  invader  was  worth. 

Add  a  mothership 

Once  in  a  while,  a  mothership  worth  250  points  can  travel  across  the  top 
of  the  battlefield.  If  the  player  hits  it,  they  get  a  bonus. 


Add  shields 

Add  floating  shields  the  player  can  hide  behind.  You  can  add  simple 
shields  the  enemies  and  player  can’t  shoot  through.  Then,  if  you  really 
want  your  game  to  shine,  add  breakable  shields  that  the  player  and  ^ 
invaders  can  blast  holes  through  after  a  certain  number  of  hits. 

Add  divebombers 

Create  a  special  type  of  enemy  that  divebombs  the  player.  A  divebombing 
enemy  should  break  formation,  take  off  towards  the  enemy,  fly  down 
around  the  bottom  of  the  screen,  and  then  resume  its  position. 


T*7  "^king  tk< 

fields  bsi  (or 

Wh&*uiKe|, 

,e *'*  ike  gje. 


Add  more  weapons 

Start  an  armB  race!  Smart  bombs,  lasers,  guided  missiles...  there  are  all 
sorts  of  weapons  that  both  the  player  and  the  invaders  can  use  to  attack 
each  other.  See  if  you  can  add  three  new  weapons  to  the  game. 


Add  more  graphics 

You  can  go  to  www.headfirstlabs.com/books/hfcsharp/  to  find  more 
graphics  files  for  simple  shields,  a  mothership,  and  more.  We  provided 
blocky,  pixelated  graphics  to  give  it  that  stylized  ’80s  look.  Can  you  come 
up  with  your  own  graphics  to  give  the  game  a  new  style?  ^  - — - 


A  good  tlass  design 
should  let  you  t^nge 
out  yaphits  'w|th 
minimal  tode  thanys. 


This  is  your  chance  to  show  oJJ!  Did  you  come  up  with  a  cool  newT 
version  oJ  the  game?  Join  the  Head  First  C#  Jorum  and  claim  your 
bragging  rights:  wrwwr.headJirstlahs.com/hooks/hJcsharp/ 
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appendix  i:  leftovers  ^ 

The  top  5  things  we  wanted 
to  include  in  this  book 


The  fun’s  just  beginning! 

We’ve  shown  you  a  lot  of  great  tools  to  build  some  really  powerful  software  with  C#.  But 
there’s  no  way  that  we  could  include  every  single  tool,  technology,  or  technique  in  this 
book— there  just  aren’t  enough  pages.  We  had  to  make  some  really  tough  choices  about 
what  to  include  and  what  to  leave  out.  Here  are  some  of  the  topics  that  didn’t  make  the 
cut  But  even  though  we  couldn’t  get  to  them,  we  still  think  that  they’re  important  and 
useful,  and  we  wanted  to  give  you  a  small  head  start  with  them 
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there’s  so  much  more  LINQ 


#1  LINQ  to  XML 

XMI  j — or  Extensible  Markup  Language  is  a  format  for  files  and  data  streams  that  represents  complex  data  as  text. 
The  .NE'E  framework  gives  you  some  really  powerful  tools  for  creating,  loading  and  saving  XML  files.  And  once 
you’ve  got  your  hands  on  XML  data,  you  can  use  LINQ. to  query  it.  Add  add  “using  System.  Xml .  Linq;”  to 
the  lop  of  a  file  and  enter  this  method — it  generates  an  XML  document  to  store  Starbuzz  customer  loyalty  data. 

private  static  XDocument  GetStarbuzzData ( )  { 

XDocument  doc  =  new  XDocument ( 

new  XDeclaration ("1 . 0",  "utf-8",  "yes"), 

new  XComment ("Starbuzz  Customer  Loyalty  Data"), 

new  XElement ("starbuzzData", 

new  XAttribute ("storeName",  "Park  Slope"), 
new  XAttribute ("location",  "Brooklyn,  NY"), 
new  XElement ("person" , 

new  XElement ("personallnfo", 

new  XElement ("name",  "Janet  Venutian") , 
new  XElement ("zip",  11215)), 
new  XElement ("favoriteDrink",  "Choco  Macchiato") , 
new  XElement ("moneySpent",  255), 
new  XElement ("visits",  50)), 
new  XElement ("person" , 

new  XElement ("personallnfo", 

new  XElement ("name",  "Liz  Nelson"), 
new  XElement ("zip",  11238)), 
new  XElement ("favoriteDrink",  "Double  Cappuccino"), 
new  XElement ("moneySpent",  150), 
new  XElement ("visits",  35)), 
new  XElement ("person" , 

new  XElement ("personallnfo", 

new  XElement ("name",  "Matt  Franks"), 
new  XElement ("zip",  11217)), 
new  XElement ("favoriteDrink",  "Zesty  Lemon  Chai") , 
new  XElement ("moneySpent",  75), 
new  XElement ("visits",  15)), 
new  XElement ("person" , 

new  XElement ("personallnfo", 

new  XElement ("name",  "Joe  Ng") , 
new  XElement ("zip",  11217)), 
new  XElement ("favoriteDrink",  "Banana  Split  in  a  Cup"), 
new  XElement ("moneySpent",  60), 
new  XElement ("visits",  10)), 
new  XElement ("person" , 

new  XElement ("personallnfo", 

new  XElement ("name",  "Sarah  Kalter") , 
new  XElement ("zip",  11215)), 
new  XElement ("favoriteDrink",  "Boring  Coffee"), 
new  XElement ("moneySpent",  110), 
new  XElement ("visits",  15)))); 

return  doc; 

> 
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Save  and  load  XMl  files 

You  can  write  an  XDocument  object  to  the  console  or  save  it  to  a  file,  and  you  can  load  an  XML  file  into  it: 

The  object's  LoadO  and 

SaveO  methods  read  and  write  XML 
tiles  And  its  ToStringO  method 
renders  everything  ins.de  it  as  one  bio 
XML  document 

Query  your  data 


XDocument  doc  =  GetStarbuzzData ( ) ; 

Console. WriteLine (doc.ToString () ) ; 
doc. Save ("starbuzzData.xml") ; 

XDocument  anotherDoc  =  XDocument. Load ("starbuzzData.xml") ; 


Here’s  a  simple  LINO  query  that  queries  the  Starbuzz  data  using  its  XDocument:  „  . 

1  ^  1  7  1  The  DestendantsO  method 

var  data  =  from  item  in  doc. Descendants  ("person")  returns  a  reference  to  an 

select  new  {  drink  =  item. Element  ("favoriteDrink")  .Value,  object  that  you  tan  plug 

moneySpent  =  item. Element ("moneySpent") .Value,  right  into  L|N<$ 

zipCode  =  item. Element ("personallnfo") .Element ("zip") .Value  ); 
foreach  (var  p  in  data)  yj*  a|^dy  kriow  ^  ^  ^ 

Console .  WriteLine  (p .  ToString  ( ) ) ;  methods  Jnd  use  ^  ^  j  ^  ^  ^ 

that  works  really  well  with  the  ElemewfcO  method 
And  you  can  do  more  complex  queries  loo:  ?K- 


var  zipcodeGroups  =  from  item  in  doc. Descendants ("person") 
group  item. Element ("favoriteDrink") .Value 
by  item. Element ("personallnfo") .Element ("zip") .Value 
into  zipcodeGroup 
select  zipcodeGroup; 
foreach  (var  group  in  zipcodeGroups) 

Console. WriteLine ("{0}  favorite  drinks  in  (1)", 

group. Distinct () .Count () ,  group. Key) ; 


'  ElementO  returns  an 
XBlement  object,  and 
you  can  use  its  properties 
to  check  speci-fic  values 
in  your  XML  document- 


Read  data  from  an  RSS  feed 


You  can  do  some  pretty  powerful  dungs  with  LINQ,to  XML.  Here's  a  simple  query  to  read  articles  from  our  blog: 

f  XDocument  ourBlog  =  XDocument .  Load  ("http :  //www.  stellman-greene .  com/ feed")  ;  — 

y  Console. WriteLine (ourBlog. Element ("rss") .Element ("channel") .Element ("title") .Value); 

J  var  posts  =  from  post  in  ourBlog. Descendants ("item") 
r\  select  new  <  Title  =  post. Element  ("title")  .Value,  The  XD°t«»e"tLoadO  method  has 

/  Date  =  post  .Element  ("pubDate")  .Value ) ;  several  overloaded  Con  ruC  s 

f  foreach  (var  post  in  posts)  ?ulls  Aii*  3 

i  Console. WriteLine (post .ToString () ) ; 

x.  Stick  a  button  on  a  -form,  make  sure  you've  *  o  .1  J-  n  II  ^ C 

got  "using  System. X">l  Lin*y''  at  the  top,  type  Wie  used  fhe  URL  o+  our  blo^  Duildir.^  Ut t 
this  guery  into  its  event  handler,  and  check  sidUar^reene  £<* 

out  what  it  prints  to  the  Console 


Wt  wed  LWe  URL  of  our  bloj,  Building  Btttee  Software 

Wbty:/ / wu/u/.s-bdlmar>— yeene  Tom/ 


you  are  here  ► 
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refactoring  is  a  great  programming  habit 


*1  Refactoring 


Refactoring  means  changing  the  way  your  code  is  structured  without  changing  its  behavior.  Whenever  you  write  a 
complex  method,  you  should  take  a  few  minutes  to  step  back  and  figure  out  how  you  can  change  it  so  that  you  make  it 
easier  to  understand.  Luckily  the  IDE  has  some  very  useful  refactoring  tools  built  in.  There  are  all  sorts  of  refactorings 
you  can  do — here  are  some  we  use  often. 

Extract  a  method 


W  hen  we  were  writing  the  control-based  Tenderer  for  Chapter  1 3,  we  originally  included  this  foreach  loop: 


foreach  (Bee  bee  in  world. Bees)  { 


These  four 
litres  move  a 
BeeControl  from 
f.he  Field  form 
to  the  Hive  form 


beeControl  =  GetBeeControl (bee)  ; 
if  (bee. InsideHive)  { 

if  (fieldForm. Controls .Contains (beeControl) )  ( 
fieldForm. Controls .Remove (beeControl) ; 
beeControl . Size  =  new  Size (40,  40); 
hiveForm. Controls. Add (beeControl) ; 
beeControl . BringToFront ( ) ; 
if  (hiveForm. Controls. Contains (beeQontrol) ) 


} 


else 

hiveForm. Controls. Remove (beeControl) 
beeControl. Size  =  new  Size  (20,  20); 
fieldForm. Controls .Add (beeControl) ; 
beeControl . BringToFront ( ) ; 


beeControl .Location  =  bee. Location; 


And  these  four 
lines  move  a 
BeeControl  from 
the  Hive  form  to 
the  Field  form. 


One  of  our  tech  reviewers,  Joe  Albahari,  pointed  out  that  this  was  a  little  hard  to  read.  He  suggested  that 
we  extract  those  two  four-line  blocks  into  methods.  So  we  selected  the  first  block,  right-clicked  on 
it.  and  selected  “Refactor  »  Extract  Method...” — this  window  popped  up: 


VVe  typed  in  a  name 
for  the  new  method 
We  decided  to  tall  rt 
MoveBeeFromFieldToHiveO 
betause  that  pretty  muth 
describes  what  the  tode 
does 


Extract  Method 


New  method  name: 


mm 


MoveBeefromFleldT  oHive| 

Preview  method  signature: 


private  void  MoveBeeFromFeldToHive(BeeControl  beeControl) 


OK 


Cancel 


The  IDE  examined 

the  Code  that  we 
selected  and  f  igured 
out  that  it  uses  a 
BeeControl  variable 
Called  beeControl, 
so  it  added  it  as  a 
parameter  to  the 
method 


Then  wc  did  the  same  thing  for  the  other  four-line  block,  extracting  it  into  a  method  that  we  named 
MoveBeeFromHiveToField().  Here's  how  that  foreach  loop  ended  up  it's  a  lot  easier  to  read: 

foreach  (Bee  bee  in  world. Bees)  ( 

beeControl  =  GetBeeControl (bee) ; 
if  (bee. InsideHive)  ( 

if  (fieldForm. Controls .Contains (beeControl) ) 

MoveBeeFromFieldToHive (beeControl) ; 

}  else  if  (hiveForm. Controls. Contains (beeControl) ) 
MoveBeeFromHiveToField (beeControl,  bee) ; 
beeControl . Location  =  bee. Location; 

) 

706  Appendix  i 


leftovers 


Rename  a  variable 


Back  in  Chapter  3,  we  explained  how  choosing  intuitive  names  for  your  classes,  methods,  fields,  and 
variables  makes  your  code  a  lot  easier  to  understand.  The  IDE  can  really  help  you  out  when  it  comes 
to  naming  things  in  your  code.  Just  right-click  on  any  class,  variable,  field,  property,  namespace, 
constant — pretty  much  anything  that  you  can  name — and  choose  “Refactor  »  Rename”.  We  did  it 
with  “beeControl”  in  the  code  from  the  simulator.  Here’s  what  popped  up: 


This  window  lets  you 
Choose  a  new  name 
■Poe  the  item  l-P 
renamed  this,  say, 
"Bobbo",  then  the  IDE 
would  Jo  throujh  the 
Code  and  ehanje  every 
sinjle  occurrence  oP  it 
to  "Bobbo-. 


Rename 


0® 


New  name: 

[  beeControl 

Location: 

Beehr/e_amulator.Renclerer.DrawBeesO 

0  Preview  reference  changes 

□  search  in  comments 

□  Search  n  strings 


OK 


Cancel 


The  IDE  does  a  really 

thorough  job  oP  renaming 
|P  you  rename  a  class,  it’ll 
ehanje  every  statement 
that  instantiates  it  or  uses 
i-t  You  Can  click  on  any 
occurrence  oP  the  name, 
anywhere  in  the  Code,  and 
the  IDE  will  make  the 

ehanje  everywhere  in  your 
yrojram. 


Consolidate  a  conditional  expression 

Here’s  a  neat  way  to  use  the  “Extract  Method”  feature.  Open  up  any  program,  add  a  button,  and  add 
this  code  to  its  event  handler: 

private  void  buttonl_Click (object  sender,  EventArgs  e)  { 
int  value  =  5; 
string  text  =  "Hi  there"; 

if  (value  ==36  ||  text. Contains ("there") ) 

MessageBox . Show ( "Pow ! " ) ; 

I 


Select  everything  inside  die  if  statement:  value  ==36  |  |  text  .Contains  ("there") .  Then 
right-click  on  it  and  select  “Refactor  »  Extract  Method...”.  Here’s  what  pops  up: 


Every  Conditional 
e*yression  evaluates  to 
a  bool,  so  the  IDE  will 
Create  a  method  that 
returns  a  bool  and 
replace  the  Conditional 
test  with  a  call  to  that 

method 


Extract  Method 


New  method  name: 

jESSUSS 

Preview  method  signature: 
private  state  bnnl  NewMethodflnt  value,  string  text) 


OK 


Cancel 


The  expression  uses  two 
variables  called  value  and 
text,  so  the  IDE  added 

parameters  to  the  method 
usinci  those  names 

T 

h/ot  only  will  this  make 
the  Code  easier  to  read, 
but  now  you  ve  jot  a 
new  method  that  you 
can  reuse  elsewhere? 


you  are  here  ► 
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explore  the  toolbox 


*$  Some  of  our  favorite  Toolbox  components 

This  was  a  hook  about  learning  C#,  not  learning  the 
ins  and  outs  of  the  components  that  ship  with  .NET. 

Still,  we’ve  got  our  favorites,  and  we  thought  we’d 
share  a  lew  of  them  with  you. 


Backo,roundWorker  *  one  those  lr"r'-'v,s'Ad' 

eomplents  (like  Timer)  that  £ t* 

_  J  L,r  form  that  does  something  really 
nttt-S  lets  y«»  easily  build  multithreaded 
applications  \ 


dust  drag  or,e  or,  your  form  and  double-click 
or,  it  (or,  if  you  want,  instantiate  it— but 
don't  forget  to  dispose  it/).  Then  add  an 
event  handler  to  do  the  work  that  you  want 
to  run  in  the  background 


S  backgroundWorker  1 


VVhen  you  call  its  RunVVorkerAsyncO  method, 
it  fires  off  the  DoWorkO  method— but  the 
Catch  is  that  it  runs  it  in  another  thread 
That  means  it  does  its  work  in  parallel  With 
the  other  stuff  you r  program's  doing 


/our  process  can  report  its  progress  back 
to  you  by  Calling  the  BackgroundWorker'* 
ReportProgressO  method— that  causes  it  to 
raise  its  ProgressChanged  event 


We  set  up  this 
“Happiness''  Counter  in 
the  "Feelings"  category, 
and  fed  it  data  using 
Performance  Counter. 
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FileSystemWatcher  pretty  mueh  does  what  it  sounds 
like  it  does— it  watches  y our  -filesystem  to  see  if 
something's  Changed  v 


'  u’V  r°^r  type  ®f  file 
•t  should  look  for  Hike  *  LV,  set  the  Path 

»  ^  the  directory  it  needs  to  watch,  and 

ft  “"^ll  *  ,00k  m  s^d.reetor,es  with  its 

Includeiiubdhreetories  property. 


*53  filesystem  Watcher  1 


Once  you've  set  it  up,  it  watehes  the  directory  for 
any  new  or  thanked  files-  A*  soon  as  a  file  s  added, 
thanked,  or  deleted,  it  raises  its  Changed  event 
It's  also  got  Created,  Deleted,  and  Renamed  events 
to  do  more  specific  tracking 


When  the  F.leSystemWateher  ra.ses  an  event, 
,t  passes  information  about  the  that 
thanked  (or  added,  or  deleted,  eU-) 

pileSystemtventAry  object- 


**  "7,  “  V,  ui  u»rf 
i£w«  Mo»u  u*1  lets 

you  monitor  processes  r 


Tlie  PerformanfieCounter  Component  lets  you  make 
information  about  your  program  available  to  the  Windows 
performance  monitoring  system  Use  | nCrementO  and 
Decremento  or  set  its  Rawl/alue  property  As  soon  as  you 
do,  you  can  see  the  data  in  the  Performance  Monitor 


—I  perform  anceCounter  1 


Windows  keeps  its  performance  Counters  m  categories,  so 
you'll  need  to  Create  a  category-there  are  methods  .n 
System  Diagnostics  that  let  you  do  that  Then  just  hook 
up  your  P erfor manCeCounter  to  the  category Jou  Created, 
and  start  sending  diagnostic  info  to  your  hearts  delight 


you  are  here  ► 
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so  that’s  why  that  class  is  called  Console 


*4  Console  Applications 

Most  C#  hooks  start  with  console  applications.  We  thought  that  was  boring.  It’s  a  lot 
more  satisfying  to  build  programs  that  look  like.  well. ..that  look  like  anything  at  all.  And 
that’s  what  a  console  program  isn't.  But  sometimes  you  do  need  to  write  a  command-line 
application.  Luckily,  it's  pretty  straightforward.  Here's  how: 


Create  a  Console  Application  project 

Any  project  can  be  a  console  application.  Go  to  a  project,  select  “Properties”  from  the 
Project  menu,  and  change  die  “Output  type”  to  “Console  Application”.  But  it's  easier  to 
create  one  from  scratch. 


The  IDE  only  adds  one  file— Program.es 

And  it’s  got  an  empty  entry  point...  and  that's  it. 

class  Program 
( 

static  void  Main (string!!  args) 

1 


you  Si 

,h  CKfP^  ?  and  Un  it  ihfe  a 

tr*  Have  it  read  a 

ilenamc  that  you  pass  ^  or) 
£o^d_|,  and  ^  ^  ^ 

hex  dump.  Have  *  take  data  (tom 
standard  ,»?»i  (using  tKe  Cohso(e 
KeadUneO  and  dump  that  data 
rr4  * a  duB,p  Tkeh  look  up 
tKe  Un'%  "cd"  and  see  if 

you  can  reproduce  it  in  C#. 
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Use  the  args  parameter  for  command -line  arguments 

Your  entry  point  takes  one  parameter,  a  string  array  called  args  that  contains  the  command-line 
arguments.  You  already  know  how  to  use  the  Console. WriteLineO  method  there  are  some  odier 
useful  console  methods,  including  ReadLineQ  and  ReadKeyQ. 

class  Program  { 

static  void  Main (string [ ]  args)  { 

Console. WriteLine ("I  got  (0)  arguments",  args. Length) ; 
for  (int  i  =  1;  i  <=  args. Length;  i++) 

Console. WriteLine ("Argument  # { 0 }  is  (1)",  i,  argsfi  -  1]); 
Console. Write ("Enter  some  text:  ") ; 
string  input  =  Console. ReadLine () ; 

Console .WriteLine ("You  entered:  (0)",  input); 

Console. WriteLine ("Press  any  key  to  end..."); 

Console. ReadKey () ; 

) 

) 


Debug  your  program  in  a  console  window 

When  you  debug  your  program,  the  IDE  pops  up  a  console  window.  The  ReadLine0  and 
ReadKeyQ  methods  gel  their  input  from  that  window  just  type  into  it.  And  instead  of  writing 
to  the  Output  window;  a  console  application  writes  to  this  console  window  instead.  You  can  set 
the  command-line  arguments  in  the  “Debug”  page  of  the  Project  Properties  w  indow. 


file:///C:/Docum«nts  and  Settings/Administrator/My  Documents/Visual  Studio  2008/Projects/Con... 

|l  got  3  arguments 
Argument  HI  is  first 
Argument  82  is  second 
Argument  83  is  third 

Enter  some  text:  ***  this  is  some  text  *** 

Vou  entered:  ***  this  is  some  text  *** 

Press  any  keg  to  end... 


you  are  here  ► 
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xaml  is  pronounced  “zammel” 


#5  Windows  Presentation  Framework 


Windows  Presentation  Framework,  or  WPF,  is  Microsoft’s  next-generation  platform  lor 
building  visual  applications.  It’s  pretty  amazing-  it  has  XML- based  layout,  scalable  controls, 
a  totally  new  system  for  controls,  2-D  and  3-D  graphics  and  animation,  text  flow  and 
document  formatting,  and  there’s  even  a  cross-platform  web  browser  plugin  that  uses  it. 

Unfortunately,  while  WPF  is  a  really  cool  and  highly  capable  technology,  it’s  not  a  particularly 
good  tool  for  teaching  C#.  And  that  was  our  goal — getting  C#  concepts  into  your  brain  as 
quickly  and  easily  as  possible. 

Take  a  second  and  create  a  new  WPF  application  Just  create  a  new  project  using  the  IDE,  but 
don't  create  a  new  Windows  Forms  Application  project.  Instead,  select  WPF  Application. 
You’ll  immediately  notice  a  dill’erence  in  the  IDE:  ,  .  re  m  i 


The  biggest  di *Wee  you'll  not-Ce  is  that  the  W 
deader  looks  nothin  like  the  one  your e  used  to 
Well  take  a  closer  look  at  it  in  a  minute 


U  |fc  'X 


WpfApphcafionl  *  Microsoft  Visual  Cff  2008  Express  Edition 


J&O  Warmgs,  IjOMessages 


&  E*  p>and<r 
Frame 


Gnj 


:  EMM 


Look  closely  at  the 
toolbo*— it's  got 
a  whole  new  set  of 
Controls. 


f  Here  s  the  -familiar  error  list 
V.  and  output  window  that  you've 
been  using. 


The  properties  look  totally 
different  That's  because  you're 
using  it  to  Change  attributes^^ 
in  a  XA/V1L  f  ile,  and  not 
properties  on  objects. 
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Drag  a  button  out  of  the  toolbox  and  onto  the  form.  If  this  were  a  Windows 
Forms  application,  the  IDE  would  add  code  to  Fbrml.Designer.es  to  add  a  control  to 
the  Form  1  object.  But  VV'FF  is  dilferent  it  uses  an  XML-based  language  called  XAML 
to  define  how  the  user  interface  is  laid  out. 


Drag  -this  slider  up 
and  down  -to  Zjoorr. 
in  and  out  When 
you  zoo**  in  really 
dlose,  your  user 
i nt create  still  looks  j 
<y>od— it  doesn’t 
yfc  pi«lated 


XM 1L  stands 
■for  "Extensible 


Go  to  the  XML  editor  and  add  a  second  button  by  typing  the  bold  line  below  into  the  XAML  editor.  You’ll  notice 
how  the  IDE’s  IntelliSense  does  a  good  job  of  helping  you  enter  all  the  XML  tags. 

<Grid> 

<Button  Height="23"  Margin="98, 43, 105, 0"  Name="buttonl" 

VerticalAlignment="Top"  Click="buttonl_Click">Button</Button> 

<Button  Height="23"  Margin="5,5,100,20"  Name="button2" 

VerticalAlignment="Top"  Click="button2_Click">Another  button</Button> 

</Grid> 

When  you  get  to  the  “Click="button2_clic*" ”  part  of  the 
line,  don’t  type  in  the  name  of  the  event  handler.  Instead,  use  the 
IntelliSense  window  that  pops  up  to  tell  the  11)1-1  to  add  a  new  event 
handler.  As  soon  as  you  finish  the  line,  you’ll  see  a  new  button  appear 
in  the  designer.  Switch  over  to  the  Windowl.xaml.cs  tab,  and  you’ll 
find  a  a  new  button2_Click  method  there. 

That’s  all  the  WPF  and  XAML  that  we  can  include  here.  But  now 
that  you've  got  the  tools  to  start  learning  about  WPF,  we  definitely 
recommend  that  you  take  a  look  at  Programming  WPF  by  Chris 
Sells  and  Ian  Griffiths.  It’s  available  from  the  O’Reilly  website: 

http://www.oreilly.com/. 
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read  this  awesome  book  next 


Rid  you  know  that  C#  and  the  .NET  Framework  can... 


*  Give  you  Much  More  power  over  your  data 
with  advanced  LiNQ  queries?  Serialize 
objects  to  an  xml  file? 

*  AcceSS  webSiteS  and  other  MetworK 
resources  uSin^  built-in  claSSeS? 

*  Let  you  add  advanced  encryption  and 
Security  to  your  prograMS? 

*  Create  coMplex  Multithreaded  applications? 

*  Let  you  deploy  your  claSSeS  So  that  other 
people  can  uSe  theM? 


*  uSe  regular  expressions  to  do  advanced 
text  Searching? 


There’s  a  great  book  that  explains  it  all! 

It’s  called  C#  3.0  in  a  Nutshell  by  Joseph  Albahari  and 
Ben  Albahari,  and  it's  a  thorough  guide  to  everything 
that  C#  has  to  offer.  You'll  learn  about  advanced  C # 
language  features,  you'll  see  all  of  the  essential  .NET 
Framework  classes  and  tools,  and  you’ll  learn  more 
about  what’s  really  going  on  under  the  hood  of  C#. 

Check  it  out  at  http:/ / www.oreilly.com/. 
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A  Desktop  Quick  Reference 


O’REILLY’ 


Joseph  Alhahari 
&  Ben  Alhahari 


Index 


Symbols 

!=  operator  68 
&&  operator  68,  77 
*=  operator  64,  136 
*  operator  64 
+=  operator  64 
+  operator  64 
casting  1 29 
-=  operator  136 
-  operator  64 
/  /  (slashes)  66 
/  operator  64 
<  operator  68 
==  operator  67,  68 
=  operator  64,  67 
>  operator  68 

@  in  front  of  filenames  389,  40 1 
\n  15,66,401 
\t  401 

|  |  operator  68 

A 

abstract  classes  278—285 
Fireside  Chat  284-285 
usefulness  279-280 
abstraction  as  principle  of  OOP  288 
abstract  keyword  281 
abstract  methods  278,281 
access  modifiers  273—274 
internal  273 
private  273 


protected  273 

protected  versus  private  or  public  276 
public  273 
scope  274 
sealed  273 

Adventure  Game  program  (see  labs,  #2  The  Quest) 
Albahari,Joe  706 
allocate,  defined  405 
allocated  resources  405 
Anatomy  of  a  program  52—53 
.NET  Framework  52 
classes  52,  53 
methods  52,  53 
namespaces  52 
parameters  53 
statements  53 
using  lines  52 
Anatomy  of  a  query  660 
AND  operator  68 

animal  inheritance  program  216—222 
animation  566—567 
building  control  573 
double  buffering  608-6 1 3 
AppendAUText( )  method  400 
Appliance  project  266—270 
Appliance  class  266 
downcasting  268 
interfaces  269 
upcasting  267 
interfaces  269 

application  design  (see  design) 
applications 

compiling  47 
console  7 1 0-7 1 1 
debugging  47 


this  is  the  index 


the  ndex 


applications  ( continued) 
deploying  37,  38 
running  36 
running  in  IDE  36 
architecture  531 
args  parameter  711 
arrays  148—149,  262 

deck  of  cards  3 1 5—3 1 6 
finding  length  1 49 
versus  Lists  318—320,325 
assemblies  273 
attributes  421 


BackColor  property  5 1 
BackgroundWorker  708 
backing  held  193,198 
Baseball  Simulator  project  484—501 
callbacks  507-509 
Fan  class  494—497 
Pitcher  class  494-497 
subscription  and  public  events  505 
base  classes  214,  217 
colon  (:)  222 
constructors  233 
extending  221 

subclasses  accessing  with  base  keyword  232 
upcasting  267 
using  subclasses  instead  227 
base  keyword  232,  275 
Beehive  Simulator  project  239-249,  252-265 
adding  new  form  544 
AnimateBees( )  method  6 1 3 
animating  with  controls  566—567 
building  control  573-575 
images  574-575 
timer  575 
Bee  class  524—525 

Go( )  method  533-535,  542-543 
BeeControl  574-579 


animating  bees  on  form  580— 58 1 
creating  button  to  add  to  form  576 
creating  from  UserControl  578 
disposing  577 
implementation  579 
ResizeCells  method  59 1 
BeeState  enum  525-527 
Bitmap  class  593 
building  form  241 

building  Worker  and  Queen  classes  241 

class  hierarchy  with  Worker  and  Queen  classes  253 

collection  of  bees  555 

Color. Transparent  589 

creating  Bee  class  246 

DateTime  class  548 

Dictionary  objects  569 

double  buffering  609-6 1 3 

drawing  picture  on  form  596-597 

encapsulation  537 

extending  through  inheritance  245—249 
fixing  transparency  problems  60 1 
Flower  class  520-522 
for  loops  537 
forms 

adding  hive  and  held  582 
clearing  out  all  controls  583 
FieldForm  586-587 
FormBorderStyle  property  582 
HiveForm  586-587 
Location  property  582 
Reset  button  587 
Graphics  object  592 
Hive  class  529-530 

adding  methods  532-533 
exceptions  539 
updates  540-541 
honey  production  246 
interfaces  254—263 
inheritance  263 
references  260-261 

making  Queen  class  inherit  from  Bee  class  247 
making  Worker  class  inherit  from  Bee  class  247 
NectarHarvested  variable  523 
number  of  bees  533 
object  model  518 


B 
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OutOfHoneyException  468 
overview  of  what’s  to  be  added  519 
Paint  event  handler  602 
performance  issues  589—591 
Point  object  539 
printing  616—619 

code  for  the  Print  button  6 1 9 
event  handler  for  the  Document’s  PrintPage 
event  618 

Print TableRow( )  method  6 1 8 
read-only  automatic  properties  523 
RemoveAllControls( )  method  583 
removing  dead  flowers  and  retired  bees  537 
Renderer  568-569 
Renderer  class  583-585 
DrawBees( )  584 
DrawFlowers( )  584 
GetBeeControl( )  585 
MoveBeeFromFieldToHive( )  585 
MoveBeeFromHiveToField( )  585 
RemoveRetiredBeesAndDeadFlowers( )  585 
Resizelmage  method  591 
resizing  images  592—593 
Show( )  method  587 
timers  546 

adding  to  program  548 
disposing  577 
events  and  delegates  547 
Render( )  method  583 

ToolStrip  control,  adding  Open,  Save,  and  Print  559 
updating  form  to  instantiate  bees  247 
using  World  to  get  statistics  545 
World  class  534-535 
code  536 
behavior  1 2 
Behind  the  Scenes 

how  forms  and  controls  repaint  themselves  605 
FINC)  using  extension  methods  657 
The  stack  vs.  the  heap:  more  on  memory  641 
Unicode  424 
visual  components  576 
binary  and  decimal,  converting  between  1 25 


binary  files  424 
comparing  429 
hex  dump  43 1 
working  with  43 1 
writing  427 
BinaryFormatter  420 

Deserialize( )  method  420,  423 
Serializable  attribute  423 
SerializationException  454 
BinaryReader  428 
Binary  Writer  427 
Birthday  Party  project  206—2 1 4 

BirthdayParty.CalculateCost( )  213 
BirthdayParty  class  207 
CakeWriting  method  212 
CalculateCost( )  method  212 
inheriting  from  Party  class  234—238 
Bitmap  class  593 
blank  space  66 
boilerplate  code  44 
bool  type  63,64,  124,  126 
bound  32 

boxed  objects  and  structs  642,  644 
boxed  struct  645 
breakpoints  450 

knowing  where  to  put  452 
BringToFront( )  method  581 
Brush  object  606 
Build  menu  47 
Build  Solution  47 
built-in  features  55 
Bullet  Points 
delegates  509 
event  handlers  509 
exception  handling  471 
FINQ,  query  statements  664 
Fists  322 
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Bullet  Points  ( continued) 
reference  variables  154 
statements  73 
try/ catch  blocks  471 
types  154 
buttons  44 

adding  code  to  interact  with  objects  1 1 3 
adding  to  form  51,  112 
BackColor  property  5 1 
Name  property  5 1 
Size  property  5 1 
Text  property  5 1 
byte  arrays  401 

moving  text  around  in  426 
byte  order  mark  434 
byte  type  1 24,  1 26 

c 

c# 

what  you  can  do  with  714 
what  you  get  with  Visual  Studio  and  2 
why  you  should  learn  2 
C#  3.0 

automatic  properties  1 95 
object  initializers  115 
Calculator  program  474—475 
temporary  solution  475 
callbacks  507 

versus  events  5 1 0 
call  stack  453 
camelCase  201 

Candy  Control  System  102-108 
capitalization  201 

Captain  Amazing  622-626,  635,  636,  645,  651 
casting  128-130 
+  operator  1 29 
automatic  1 30 
wrapping  numbers  1 29 


catch  blocks  455,457 

followed  by  (Exception)  460 
following  in  debugger  458-459 
multiple  466 

with  no  specified  exceptions  462 
chaining  49 1 ,  499 
Character  Map  424,  425 
char  type  125,  126 
checkbox  75 

class  diagrams  90,  104,  106 
moving  up,  not  down  231 
private  fields  and  types  240 
classes  52,  53,  73 

abstract  (see  abstract  classes) 

adding  56 

collection  317 

concrete  278 

copying  90 

creating  example  111 

curly  braces  66 

declaration  54 

defining  66 

designing  intuitive  classes  1 1 6 

finding  out  if  class  implements  specific  interface  262 

instances  (see  instances) 

internal  273 

looking  for  common  219 

members  273 

message  about  adding  components  to  my  class  579 

MessageBox  56 

multiple  in  same  namespace  61 

naming  102—103 

natural  structure  1 04 

never  instantiated  277 

organizing  1 06 

partial  (see  partial  classes) 

private  273 

protected  273 

public  273 

sealed  273 

serializable  42 1 
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similarities  between  1 1 6 
static  97 
subscribing  489 
using  to  build  objects  92 
versus  structs  644 

why  some  should  never  be  instantiated  280 
you  can’t  inherit  from  647 
class  hierarchy  215,220 
Hive  Simulator  253 
Clone  class 

implementing  IDisposable  630,631 
CLR  (Common  Language  Runtime)  47,  153 
code 

avoiding  duplication  217 
blocks  73 
boilerplate  44 
copying  90 

looking  at  auto-generated  1 5 
renaming  things  in  code  707 
repeating  213 
similar  214 

unwanted  code  from  IDE  1 1 
using  IDE  to  help  write  code  48-49 
collection  initializers  326—327 
collections  317,555 

Dictionary  (see  dictionaries) 
generic  325 
LINQ  556-558 
List  (see  lists) 

performing  calculations  on  662 
Queue  (see  queues) 

Stack  (see  stack) 

using  join  to  combine  two  collections  into  one  query 

671,672 

versus  tables  66 1 
colon  (:)  222 
colon  operator  256 
Color. Transparent  589 
colors  76 
columns  20 

command-line  arguments  711 


comments  66 
CompareTo( )  method  329 
compiler  47 
compiler  errors 
interfaces  254 
troubleshooting  49 
compiling  application  36,  47 
compound  operators  1 36 
concatenation  1 30 
concrete  classes  278 

conditional  expressions,  consolidating  707 
conditional  operators  68-7  0 
conditional  tests  68-70,73 
configuration  files  37 
Console. WriteLine( )  method  1 94 
console  applications  7 1 0-7 1 1 
console  window,  debugging  in  7 1 1 
constructors  197,  198,  199 
base  class  233 

building  new  with  switch  statement  4 1 5 
exceptions  in  459 
overloaded  313 
subclasses  233 
ContactDB.mdf  18,  29,  31 
ContactDBDataSet  31,  32 
ContactDBDataSet.Designer.es  31 
ContainsKey( )  method  58 1 
controls 

adding  code  564 

altering  reexisting  587 

animating  Behive  simulator  566—567 

as  objects  565 

bound  to  database  32 

clearing  out  all  on  forms  583 

custom  564 

animation  573 
disposable  objects  577 
database-driven  32—33 
disposing  577,  579 
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controls  ( continued) 

how  forms  and  controls  repaint  themselves  605 
redrawing  themselves  602 
removing  564 
visual  display  elements  570 
Controls  collection  565 
count  ++64 
count  —  64 
count  =  64 
Create( )  method  400 
CreateDirectory( )  method  400 
CryptoStream  394 
curly  braces  66,73 
curly  brackets  58,  1 1 1 
single-line  blocks  212 

D 

data 

pulling  data  from  multiple  sources  656 
storing  categories  of  310 
database-driven  controls  32—33 
database  diagram  26 
saving  27 

Database  Explorer  18,  675 
databases  3 

adding  table  20 
adding  to  project  18 
connecting  forms  to  1 7,  30 
(see  also  data  source) 

connecting  LINQ to  SQL  database  674-675 
entering  data  28-29 
LINQ  673 

LINQ querying  SQL  database  677 

multiple  tables  26 

SQL  18,  19 

SQL  Server  Express  7 


data  source 

adding  new  30 
configuring  31 
database-driven  controls  32 
Data  Source  Configuration  Wizard  18 
data  storage  7 
data  types  20 
generic  325 
DateTime  class  548 
debugger 

Break  All  button  449 
Bullet  Points  471 
catch  blocks 

followed  by  (Exception)  460 
following  flow  458-459 
multiple  466 

with  no  specified  exceptions  462 
Continue  button  449 
exploring  delegates  503 
finally  block  460 

knowing  where  to  put  breakpoints  452 

Restart  button  449 

Show  next  statement  button  449 

Step  into  button  449 

Step  Into  command  450 

Step  out  button  449 

Step  over  button  449 

try  blocks  458-459 

unhandled  exception  window  452 

uses  for  457 

Watch  window  449,457 
running  methods  in  452 
(see  also  exception  handling) 

debugging  16,47,449 
console  window  7 1 1 
Excuse  Management  program  450—451 
Debug  menu  47 

decimal  and  binary,  converting  between  125 
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decimal  type  125,126 
declaration  54 
delay  76,  79 
delegates 

Bullet  Points  509 
defined  501 

exploring  in  debugger  503 
hooking  up  to  one  event  507-509 
in  action  502-503 
multiple  events  499 
Delete( )  method  400 
deploying  application  37,  38 
deployment  package  7 
design  531 

intuitive  applications  34—35 
intuitive  classes  1 1 6 

making  code  intuitive  with  class  and  method  names 
102-103 

professional  looking  applications  35 
user’s  needs  5 
destructor  628 
dialog  boxes  398-400 
as  objects  399 
customized  401 
popping  up  397 
DialogResult  397-399 

excuse  management  program  410 
dictionaries  335-337 
Add( )  method  335 
adding  or  removing  items  336 
ContainsKey( )  335 
getting  list  of  keys  336 
getting  list  of  values  336 
keys  335 

keys  and  values  337 
looking  up  values  using  keys  336 
Tenderer  580 
Dictionary  objects  569 
Dinner  Party  Planning  project  174—185 

CalculateCostOfDecorations( )  method  1 84 
cost  estimate  1 7  5 


DinnerParty  class 
class  diagram  176 
exercise  solution  178-179 
fixing  calculator  203—204 
inheriting  from  Party  class  234—238 
numericUpDown  control  183 
recalculating  new  individual  costs  183 
directories 

creating  new  400 
deleting  400 
getting  list  of  files  400 
Dispose()  method  406,  577 
finalizers  632,  634 
making  object  serialize  in  633 
using  statement  630-632 
DivideByZero  error  443 
DivideByZeroException  443,  448 
dividing  any  number  by  zero  443 
DogCompetition  class  312 
double  buffering  608-613 
double  type  125,126 
downcasting  268,  269 
failure  270 

E 

encapsulation  183-204,  435,  644 
as  principle  of  OOP  288 
automatic  properties  195 
better  276 
defined  185 
example  192 
ideas  for  1 9 1 
properties  193 
Renderer  568 
entry  point  55,  58,  231 
changing  56 
enumeration  3 1 0—3 1 1 
enums  311—315 
big  numbers  312 

representing  numbers  with  names  312 
versus  Lists  325  you  are  f^ere  > 
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equal  signs  67 
error  handling  462 
Error  List  49,  58 
errors 

avoiding  file  system  errors  with  using  statements  406 
compiler  errors  and  interfaces  254 
DivideByZero  443 
invalid  arguments  1 3 1 

You  must  rebuild  your  project  for  the  changes  to  show 
up  in  any  open  designers.  579 

escape  sequence  66 
EventHandler  488,  491 

using  methods  that  do  match  others  defined  by  Even- 
tHandler  491 

event  handlers  177,  188,  485 
adding  491 
automatic  492M93 
Bullet  Points  509 
excuse  management  program  408 
hooking  up  498 
how  they  work  486—487 
printing  614 

returning  something  other  than  void  49 1 
types  of  491 
event  keyword  488 
events 

callbacks  507-509 

connecting  senders  with  receivers  500 
defined  485 
delegates  499 
forms  498 

how  they  work  486—487 

naming  methods  when  raising  events  490 

raising  490 

raising  events  with  no  handlers  490 
reference  variables  500 
subscription  and  public  events  505 
versus  callbacks  510 
(see  also  event  handlers) 
exception,  defined  444 


exception  handling  439—482 
Bullet  Points  471 
catch  block  455,  457 
catching  specific  exception  types  473 
DivideByZeroException  443,  448 
dividing  any  number  by  zero  443 
exceptions  in  constructors  459 
exceptions  versus  unhandled  exceptions  462 
Excuse  Management  program  477—478 
FileNotFoundException  462 
finalizers  635 
FormatException  448 
handling,  not  burying  474 
handling  versus  fixing  475 
IDisposable  interface  472 
IndexOutOfRangeException  448 
IOException  460 
NullReferenceException  443 
OverFlowException  448 
program  stopping  with  exceptions  462 
SerializationException  453,  460 
simple  ideas  for  476 

specifying  particular  kinds  of  exceptions  462 

spotting  exceptions  445 

throwing  and  catching  exceptions  467 

try  block  455,457 

unexpected  input  456 

unhandled  exceptions  452 

using  exceptions  to  find  bugs  447 

using  statement  47 1 

why  there  are  so  many  exceptions  445 

(see  also  debugger) 

Exception  objects  444,  445 

inheriting  from  Exception  class  448 
Message  property  466 

using  to  get  information  about  the  problem  465 
Excuse  Management  project  407—411 
binary  hies  with  serialized  objects  436 
building  the  form  408 
code  problems  453 
debugging  450-451 

Random  Excuse  button  46 1 
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DialogResult  410 
event  handlers  408 
exception  handling  477—478 
Folder  button  408 
Random  Excuse  button  411 
Save  As  dialog  410 
solution  410—411 

unexpected  user  behavior  446-447 
using  debugger  to  follow  try/ catch  flow  458-459 
executable  file  47 
executing  application  36 
Exists( )  method  400 
Expand  Tables  28 
extension  methods  646,  647 
LINQ.  657 
strings  648 

F 

Farmer  class  192—198 
constructors  197 
fully  encapsulating  1 95 
testing  194—195 
features  3 
built-in  55 
fields  98 

backing  field  193 
initializing  public  fields  196 
interfaces  255 
lining  up  34 
masking  198 

method’s  parameter  has  same  name  as  a  field  1 98 
private  185-188 
constructors  197 
declaring  201 
public  1 9 1 
versus  methods  98 
versus  properties  276 
with  no  access  1 88 
File.Create()  429 
File. Open Write( )  429 


File.ReadAllBytes( )  425,  426,  434 
File.ReadAllLines( )  434 
File.ReadAllText( )  434 
File.WriteAllBytes( )  425,  426,  434 
File.WriteAllLines( )  434 
File.WriteAllText( )  434 
File  class 

Close( )  method  434 
ReadAllText( )  method  403 
static  methods  434 
versus  Filelnfo  class  434 
WriteAllText( )  method  403 
FileDialogs  403 
Filelnfo  class  400 

versus  File  class  434 
filenames,  @  in  front  of  389 
FileNotFoundException  462 
files 

appending  text  to  400 
finding  out  if  exists  400 
get  information  about  400 
reading  from  or  writing  to  400 
(see  also  streams) 

where  Visual  Studio  stores  them  1 6 
writing  412 
FileStreams  387,  388 
Binary  Writer  427 
StreamWriter  389 

versus  StreamReader  and  StreamWriter  434 
FileSystem Watcher  709 
Filter  property  398 
finalizers  628 

Dispose( )  method  632,  634 
exceptions  635 
fields  and  methods  635 
garbage  collection  629-63 1 
references  632 
stability  632 
when  they  run  629 
finally  block  460 
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Fireside  Chats 

abstract  classes  284—285 
Dispose( )  method  and  finalizers  634 
Five  Minute  Mystery 

The  Case  of  the  Golden  Crustacean  506 
mystery  solved  5 1 1 
flickering  images  607 
float  type  124,  126 
assigning  1 29 
foreach  loop  (lists)  32 1 ,  358 
for  loops  65,  69 
Forml.cs  8 

Forml.Designer.es  8,45,50 

changing  control  properties  1 2 
Forml.resx  14 

Form  1  form,  programs  without  231 
FormatException  448 
FormBorderStyle  property  582 
Form  Designer  3 
forms 

adding  buttons  112 
adding  method  1 1 3 
adding  variables  1 1 2 
as  objects  152-153 
connecting  to  databases  1 7,  30 
(see  also  data  source) 

CreateGraphics( )  method  594 
database-driven  controls  32 
events  498 

how  forms  and  controls  repaint  themselves  605 
OnPaint  method  605 
Paint  event  605 
PaintEventArgs  605 
redrawing  themselves  602 
Refresh( )  method  605 
(see  also  Beehive  Simulator  project,  forms) 
frames  versus  turns  549 
from  clause  664,  667 
FromImage( )  606 


G 

garbage  collection  140,153,635 
finalizers  629—631 
GDI+  594-595 
generic  collections  325,  355 
generic  data  types  325 
get  accessor  193,199 

interfaces  with  get  accessor  without  set  accssor  259 
GetFiles( )  method  400 
GetLastAccessTime( )  method  400 
GetLastWriteTime( )  method  400 
Go  To  Definition  405 
GPS  navigation  system  87 
graphical  user  interface  (see  GUI) 
graphics 

drawing  picture  on  form  596—597 
how  forms  and  controls  repaint  themselves  605 
Rectangle  597 
using  keyword  606 
Graphics  object  592,  594,  606 
CreateGraphics( )  method  595 
DrawBee( )  method  601 
DrawCircle( )  method  595 
DrawS tring( )  method  595 
FillCircle( )  method  595 
Invalidate( )  controls  605 
Paint  event  handler  602 
printing  614 
Update( )  method  605 
green  arrow  button  1 6 
GroupBox  control  207,  606 
group  keyword  667,  668 
GUI  (Graphical  User  Interface)  94 
labs,  #  1  A  Day  at  the  Races  170 
guys  (Two  Guys  project)  1 10-1 15,  117-1 18 
building  form 

adding  a  method  1 1 3 
adding  buttons  1 1 2 
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adding  code  to  interact  with  objects  1 1 3 
adding  variables  112,  113 
creating  Guy  class  and  two  instances  110 
sample  code  1 1 1 
GZipStreams  387 

u 

heap  100,  101 

garbage  collection  1 40 
structs  637 
versus  stack  64 1 
Hebrew  letters  425 
hex  dump  431 

StreamReader  and  Stream  Writer  433 
using  file  streams  to  build  hex  dumper  432 
hexadecimal  431 
working  with  432 
hierarchy  215 
defined  221 

I 

IClown  interface  258 

access  modifiers  274—275 
extending  271-272 
IComparable  interface  329 
IGomparer  interface  330 
complex  comparisons  332 
creating  instance  331 
multiple  classes  331 
SortBy  held  332 
IDE 

auto-generated  code  7  3 
behind  the  scenes  1 4 
buttons  44 

changing  names  of  files  1 1 

changing  things  in  50 

compiler  errors,  troubleshooting  49 

creating  new  projects  8 

Error  List  49 

green  arrow  16 


helping  users  code  48—49 
importing  images  14 
making  changes  in  45 
New  Project  window  8 
Properties  window  44 
renaming  things  in  code  707 
Reset  Window  Layout  command  1 1 
running  program  in  36 
SQL  statements  1 9 
stored  procedures  1 9 
unwanted  code  1 1 

using  tabs  to  switch  between  open  hies  48 
visual  tools  7  3 

what  it  does  in  typical  application  44—45 
what  the  IDE  automates  2 
where  data  is  stored  29 
Windows  Forms  Application  project  44 
XAML  713 
IDE  toolbar 

green  arrow  button  1 6 
Save  icon  15 

Stop  Debugging  button  1 6 
IDisposable  interface  405,  473,  630 
avoiding  exceptions  472 

IDs 

auto-generated  21 
unique  20 
if/ else  statements  67 
if  statements  131 
images 

drawing  picture  on  form  596—597 
hxing  transparency  problems  60 1 
Bickering  607 
performance  issues  590 
Rectangle  597 
resizing  592-593,  606 

TrackBars  to  zoom  an  image  in  and  out  603—604 
images,  importing  14 
index  (arrays)  148—149 
IndexOutOfRangeException  448 
infinite  loops  7 1 
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inherit,  defined  215 
inheritance  213—250 

as  principle  of  OOP  288 
avoiding  duplication  of  code  2 1 7 
classes  you  can’t  inherit  from  647 
class  hierarchy,  Hive  Simulator  253 
class  that  contains  entry  point  231 
looking  for  common  classes  219 
multiple  286 

passing  instance  of  subclass  231 
subclasses  225-226 
(see  also  interfaces) 

InitialDirectory  propery  398 
initialization  115 

Initialized  omponent( )  method  1 98 
installation,  testing  39 
instances  93 
creating  94 
example  111 
heap  101 
static  keyword  99 
defined  93 
fields  98 

keeping  track  of  things  98 
non-static  methods  97 
instantiation,  interfaces  260 
int  63 

integers,  using  in  code  137 
IntelliSense  window  577,  595 
CreateGraphics( )  method  606 
interface  keyword  255 
interfaces  254-276 
colon  operator  256 
compiler  errors  254 
containing  statements  270 
downcasting  269 
easy  way  to  implement  270 
example  code  258 
fields  255 


finding  out  if  class  implements  specific  interface  262 

get  accessor  without  a  set  accssor  259 

implementing  257—258 

inheriting  from  other  interfaces  263 

is  keyword  262,  265 

like  contracts  270 

naming  254 

new  keyword  260 

object  references  versus  interface  references  276 
properties  255 
public  255 

public  void  method  259 
references  260-261 
why  use  276 
upcasting  269 
void  method  258 
why  use  270,276 
internal  access  modifier  273 
int  type  124,  126,  127 
assigning  value  137 
declaring  137 

invalid  arguments  error  131 
IOException  460 
is  keyword  262,  265 

J 

join  clause  671,672,677,678 

L 

labels  75 

lining  up  34 

labels  for  objects  (see  reference  variables) 
labs 

#  1  A  Day  at  the  Races 

application  architecture  1 68 
Bet  class  167 
Bet  object  169 
Betting  Parlor  groupbox  171 
dogs  array  168 
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finished  executable  1 7  2 

Greyhound  class  166 

Greyhound  object  initializer  166 

GUI  170 

Guy  class  167 

Guy  object  169 

guys  array  1 68 

PictureBox  control  166,168,170 
RadioButton  controls  1 68 
this  keyword  167 
#2  The  Quest  363-384 
Bat  subclass  377 
BluePotion  class  380 
Bow  subclass  379 
Enemy  class  376 
Enemy  subclasses  377 
form,  bringing  it  all  together  381  383 
form,  building  366-367 
form,  UpdateCharacters( )  method  382 
Game  class  370—371 
Ghost  subclass  377 
Ghoul  subclass  377 
IPotion  interface  380 
Mace  subclass  379 
Mover  class  372-373 
Mover  class  source  code  373 
Player  class  374 

Player  class  Attack( )  method  375 
Player  class  Move( )  method  375 
RedPotion  class  380 
Sword  subclass  379 
using  objects  368-369 
Weapon  class  378 
#3  Invaders  681-702 
additions  701 
animation  timer  687 
architecture  684—685 
designing  the  form  686—690 
Form  object  684 
Game  class  692 
Game  class,  filling  out  694 
Game  class  methods  693 
Game  object  684—685 
Game  object’s  Draw( )  method  69 1 
gameOver  event  689 
game  timer  689,  690 


graphics  691 
Invader  class  696 
Invader  class  methods  697 
KeyDown  and  KeyUp  events  688 
LINQ,  695 
movements  683 
Paint  event  handler  69 1 
PlayerShip  class  698 
PlayerShip  object  685 
Shot  objects  699 
Stars  class  700 
Stars  object  685 
types  of  invaders  683 
line  break  15,  66 

LINQ_(Langauge  INtegrated  Query)  556-558 
101  LINQ^  Samples  663 
combining  results  into  groups  667,  668 
connecting  to  SQL  database  674-675 
databases  673 
extension  methods  657 
from  clause  664,  667 
Invaders  lab  695 
modifying  items  662 
.NET  collections  657 
orderby  clause  664,  667 
performing  calculations  on  collections  662 
pulling  data  from  multiple  sources  656 
queries  658,  663 
querying  SQL  database  677 
query  statements  664 
scouring  comic  collections  659 
select  clause  664 
Take  statement  664 
to  XML  704-705 

reading  RSS  feed  705 

using  join  to  combine  two  collections  into  one  query 
671,672 
versus  SQL  66 1 
where  clause  664 
LINQPad  679 
lists  317-334 

Bullet  Points  322 
Compare To( )  method  329 
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lists  ( continued) 

converting  from  stacks  or  queues  358 
creating  new  325 

dynamically  shrinking  and  growing  321 
foreach  loop  321 
IComparable  interface  329 
IComparer  interface  330 
complex  comparisons  332 
creating  instance  331 
multiple  classes  33 1 
Sort( )  method  328 
sorting  328-329 
storing  types  322 
things  you  can  do  with  318 
versus  arrays  318—320,  325 
versus  enums  325 
literals  125 

Location  property  582 
logical  operators  68 
long  type  124,  126 
loops  65,  69 
infinite  7 1 
nested  77 
lowercasing  201 

M 

Main( )  method  54,  55 
masking  fields  198 
Math  class  66 

Maximize  and  Minimize  buttons  35 
MaximizeBox  property  35 
members  (class)  273 
memory  1 00 
MemoryStreams  387 

message  about  adding  components  to  my  class  579 
MessageBox  56 
methods  15,52,53 
abstract  278,  281 
adding  for  form  113 
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calling  specific  221 

curly  braces  66 

declaration  54 

defining  66 

entry  point  54,  55 

extension  (see  extension  methods) 

extracting  706 

implementing  interfaces  257—258 
Main( )  54,  55 
naming  102-103 
objects  92 

overloaded  (see  overloaded  methods) 
overriding  218,226 

parameter  has  same  name  as  a  field  1 98 
private  187-188 
public  1 9 1 

accessing  private  fields  1 88 
capitalization  201 
return  values  88 
set  and  get  accessors  199 
Show()  56 

static  (see  static  methods) 
variables  matching  types  of  parameters  131 
versus  fields  98 
with  no  return  value  1 97 
MinimizeBox  property  35 
multiple  inheritance  286 

N 

Name  property  51 
namespaces  46,  52,  55 

multiple  classes  in  same  6 1 
reserved  73 

Navigation  project  86-98 
nested  loops  77 
.NET  collections,  LINQ_  657 
.NET  Database  Objects  6 
.NET  Framework  46 
colors  76 

Random  class  1 50—1 5 1 
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tools  52 

what  you  can  do  with  714 
.NET  Visual  Objects  6,  17 
NetworkStreams  387 
new  keyword  9 1 
interfaces  260 
No  Dumb  Questions 

@  in  front  of  filenames  40 1 
\n  15,401 
\t  401 

Beehive  Simulator  project 
BeeControl  579 
for  loops  537 
Go( )  methods  533 
Hive  class  exceptions  539 
NectarHarvested  variable  523 
number  of  bees  533 
Point  object  539 

read-only  automatic  properties  523 
removing  dead  flowers  and  retired  bees  537 
ShowQ  method  587 
BirthdayParty  class  207 
boxed  objects  and  structs  644 
byte  order  mark  434 
capitalization  201 
catch  block  457 

with  no  specified  exceptions  462 
chaining  491 

changing  names  of  files  generated  by  IDE  1 1 
changing  types  154 

class  diagrams,  moving  up,  not  down  231 
classes  73 

versus  structs  644 
Close( )  method  434 
closing  streams  40 1 
columns  20 
constructors  198,  199 
controls,  altering  reexisting  587 
converting  strings  to  byte  array  40 1 
creating  new  Lists  325 
curly  brackets  58 
customized  dialog  boxes  40 1 
data  types  20 


debugger  457 

Watch  window  457 
easy  way  to  implement  interfaces  270 
encapsulation  188,  276 
entry  point  58,231 
error  handling  462 
Error  List  58 

errors,  You  must  rebuild  your  project  for  the  changes 
to  show  up  in  any  open  designers.  579 
EventHandler  491 
event  handlers  188 
adding  491 

returning  something  other  than  void  491 
types  of  49 1 

events  versus  callbacks  510 
Exception  object  445 

exceptions  versus  unhandled  exceptions  462 
extension  methods  647 
fields  with  no  access  188 
File  class  versus  Filelnfo  class  434 
FileStreams  versus  StreamReader 
and  Stream  Writer  434 
fmalizers 

exceptions  635 
using  fields  and  methods  635 
forms  as  objects  153 
frames  versus  turns  549 
from  clause  664 
FromImage()  606 
garbage  collection  153,  635 
generic  collections  325 
generic  data  types  325 
get  accessor  1 99 
graphics,  using  keyword  606 
Graphics  object  606 
guys  (Two  Guys  project)  114 
IDE 

auto-generated  code  7  3 
where  data  is  stored  29 
IDE  toolbar 

green  arrow  1 6 

Reset  Window  Layout  command  1 1 
Stop  Debugging  button  1 6 
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No  Dumb  Questions  ( continued) 

IDisposable  interface  473 
instances,  non-static  methods  97 
interface  references,  why  use  276 
interfaces 

containing  statements  270 
like  contracts  270 
why  use  276 
join  clause  677 

knowing  where  to  put  breakpoints  452 
line  break  1 5 
LINQ  663 

LINQquerying  SQL  database  677 
Lists  versus  arrays  325 
Lists  versus  enums  325 

message  about  adding  components  to  my  class  579 
method  1 5 

namespaces,  reserved  7  3 

new  projects,  Visual  Studio  2008  1 1 

null  keyword  153 

object  references  versus  interface  references  276 

OpenFileDialog,  changing  properties  579 

overloaded  constructors  3 1 3 

partial  classes  7  3 

patterns,  callbacks  510 

Point  644 

private  data  188 

program  stopping  with  exceptions  462 
programs  without  Form  1  form  231 
properties 

statements  1 99 
versus  fields  276 

protected  versus  private  or  public  276 
record  data  29 

reference  variables,  how  they  work  154 

resizing  images  606 

select  clause  664 

select  new  clause  677 

set  accessor  199 

setting  structs  equal  to  another  644 
specifying  particular  kinds  of  exceptions  462 
spotting  exceptions  445 
stack  644 


static  and  non-static  methods  97 
static  methods,  when  to  use  97 
StreamReader  401 
StreamWriter  401 
subclasses 

and  base  classes  222 
passing  instance  of  23 1 
this  variable  154 
try/finally  block  473 
try  block  457 
unhandled  exceptions  452 
unhandled  exception  window  452 
Unicode  434 
unique  IDs  20 
unwanted  code  from  IDE  1 1 
upcasting,  but  not  downcasting  270 
UserControl  606 

using  methods  that  do  match  others  defined 
by  EventHandler  49 1 
using  statement  473 
using  this  keyword  to  raise  event  49 1 
virtual  methods  231 
Visual  Studio  Express  1 1 
Watch  window,  running  methods  in  452 
why  there  are  so  many  exceptions  445 
why  use  interfaces  270 
null  keyword  153 
NullReferenceException  443 
NumericUpDown  control  89 

0 

object  initializers  115,196,197 
object  oriented  programming  (OOP)  288 
object  references,  versus  interface  references  276 
Object  Relational  Designer  window  675 
objects  91 

accessing  fields  inside  object  185 
accidently  misusing  1 84 
assigning  value  137 
as  variables  137 
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boxed  642 

building  from  classes  92 
declaring  137 

encapsulation  (see  encapsulation) 
event  arguments  488 
finalizers  (see  finalizers) 
garbage  collection  1 40 
instances  (see  instances) 
knowing  when  to  respond  484 
null  keyword  153 

reading  entire  with  serialization  420 
references  261 

reference  variables  (see  reference  variables) 
setting  equal  to  value  type  642 
states  418 

talking  to  other  objects  152 
versus  structs  639 
object  type  125 
Objectville  Paper  Co.  logo  13 
OOP  (object  oriented  programming)  288 
OpenFileDialog  579 

changing  properties  579 
initialFolder  property  403 
OpenFileDialog  control  398,  403 
OpenRead( )  method  400 
OpenWrite( )  method  400 
operators  64 

compound  1 36 
orderby  clause  664,  667 
OR  operator  68,  410 
Oven  class  266 
OverFlowException  448 
overloaded  constructors  313 

excuse  management  program  408 
overloaded  methods  343 
override  keyword  226 
overriding  methods  218 
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PaintEventArgs  605 
Paint  event  handler  602 
parameters  53,  88,  89 
capitalization  201 
same  name  as  a  held  198 
partial  classes  45,  50,  53,  59-61,  73,  78 
PascalCase  201 
patterns 

callbacks  508,510 
Pen  object  606 
PerformanceCounter  709 
performance  issues 

Beehive  Simulator  project  589-591 
images  590 
PictureBox  control  1 2 
adding  to  form  50 
double-clicking  15 

labs,  #1  A  Day  at  the  Races  166,  168,  170 
transparent  background  589 
Zoom  mode  1 3 
PictureBox  control  217 
Point  581,  644 
polymorphism  289 

as  principle  of  OOP  288 
popping  up  dialog  boxes  397 
primary  key  20—24,27 
Primary  Key  button  20 
PrintDocument  object  614—615 
printing 

Beehive  Simulator  proj  ect  61 6-6 1 9 
Graphics  object  and  event  handler  614 
PrintPage  event  handler  615 
private  access  modifier  258,  273 
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private  fields  1 85- 1 88 
constructors  197 
declaring  201 
private  methods  187—188 

Problem  Up  Close,  recalculating  new 
individual  costs  183 

Program.es  8,  54 
programs  (see  applications) 
properties  98 
automatic  195 
encapsulation  1 93 
initializing  public  properties  1 96 
interfaces  255 
public,  capitalization  20 1 
read-only  195,  196 
statements  1 99 
versus  fields  276 
Properties  window  35,  44 
protected  access  modifier  273 
protected  keyword  275 
public  access  modifier  273 
public  fields  1 9 1 
initializing  1 96 
public  methods  1 9 1 

accessing  private  fields  1 88 
capitalization  201 
public  properties 

capitalization  201 
initializing  1 96 
public  void  method  259 
publish/  folder  38 
Publish  Contacts  37 
Publish  Wizard  37 
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queries  1 9 

anatomy  of  660 
editing  with  LIN QPad  679 


LINQ,  658,  663 

using  join  to  combine  two  collections  into  one 
query  671 
queues  355 

converting  to  lists  358 
enqueuing  and  dequeuing  356 
foreach  loop  358 

R 

Racetrack  Simulator  (see  labs,  #  1  A  Day  at  the  Races) 

Random  class  150—151 

randomizing  results  1 50—15 1 

read-only  properties  195,196 

record  data  29 

refactoring  706-707 

references 

interfaces  260-261 
objects  261 
versus  values  638 
reference  variables  138—140,  500 
garbage  collection  140 
how  they  work  154 
multiple  1 39 

multiple  references  and  their  side  effects  1 42 
multiple  references  and  unintentional  changes  147 
objects  talking  to  other  objects  152 
Refresh( )  method  605 
RemoveAllControls( )  method  583 
render,  defined  568 
Renderer  class  568-569,  583-585 
animating  bees  on  form  580—58 1 
dictionaries  580 
Resizelmage  method  59 1 
reserved  words  154 
Reset  Window  Layout  command  1 1 
Resource  Designer  582 
resource  files  1 4 
result  +=64 
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result  =  64 

return  statements  88 

return  type  88 

return  values  53,  88 

risky  code  456 — 47  3 

RoboBee  class  264 

robust,  defined  454 

RSS  feed,  LINQto  XML  705 

s 

SaveFileDialog  control  399,  403 
Title  property  403 
Save  icon  1 5 
sbyte  type  124 
scope  274 

sealed  access  modifier  273 
select  new  clause  671,  672,  675-679 
select  statement  664 
semicolons  66 
serialization  416—425 

making  classes  serializable  42 1 

making  object  serialize  in  Dispose( )  method  633 

object  states  418 

reading  and  writing  serialized  files  429 
reading  entire  object  420 

serializing  and  deserializing  deck  of  cards  422—423 
serializing  objects  out  to  file  424 
what  happens  to  objects  417,419 
SerializationException  453,  460 
BinaryFormatter  454 
Server  Explorer  1 8 
Service-Based  Database  18 
set  accessor  193,199 

interfaces  with  get  accessor  without  set  accssor  259 
Setup  executable  37 
shorttype  124,126,127 


Show( )  method  56 
ShowDialog( )  method  397,  399 
similar  behaviors  214 
similar  code  214 
Size  property  5 1 
slashes  (/  /)  66 

Sloppy  Joe’s  Random  Menu  Item  project  150-151 

solution  (.sin)  file  46 

Solution  Explorer  18,  46,  48 

Sort( )  method  328 

SortBy  field  332 

source  code  files  46 

Spy  project  1 86—188 

SQL  (Structured  Query  Language)  19 

connecting  LINQto  SQL  database  674-675 
LINQquerying  SQL  database  677 
versus  LINQ  661 
SQL  databases  18,19 
SQL  Server  Express 
database  7 
hie  29 

stack  355,  644 

converting  to  lists  358 
foreach  loop  358 
popping  items  off  357 
versus  heap  641 

Starbuzz  Coffee  project  654—656 
join  clause  678-679 
Start  Debugging  47 
statements  19,  53,  73 
static  keyword  97 

creating  instances  99 
static  methods  97 
when  to  use  97 
static  void  Main( )  55 
Step  out  button  449 
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Step  over  button  449 
Stop  Debugging  button  1 6 
stored  procedures  1 9 
Stream  object  386 
StreamReader  393,  401 
hex  dump  433 
versus  FileStreams  434 
streams  386 
chaining  394 
closing  401 
different  types  387 
Dispose( )  method  406 
forgetting  to  close  388 
serializing  objects  423 
things  you  can  do  with  387 
using  hie  streams  to  build  hex  dumper  432 
using  statements  406 
writing  text  to  files  389 
Stream  Writer  389—393,  40 1 
[0]  and  [1]  401 
hex  dump  433 
versus  FileStreams  434 
Write( )  and  WriteLine( )  methods  389 
String.IsNullOrEmpty( )  240 
string  literals  389,  40 1 
strings  63 

converting  to  byte  array  40 1 
extension  methods  648 
formatting  179 
storing  categories  of  data  310 
string  type  1 24,  1 26 
concatenation  1 30 
converting  1 30 
structs  637 

boxed  642,  645 
Point  644 

setting  one  equal  to  another  640,  644 
versus  classes  644 
versus  objects  639 

Structured  Query  Language  (see  SQL) 


subclasses  214,221 

accessing  base  class  with  base  keyword  232 

constructors  233 

inheriting  from  base  class  222 

modifying  225-226 

overriding  methods  226 

passing  instance  of  231 

upcasting  267 

using  instead  of  base  classes  227 
subscription 

how  it  works  486-487 
public  events  505 
subscribing  classes  489 
switch  statements  4 1 3—4 1 5 

building  new  constructors  with  415 
syntax  66 

System. Drawing  594 
System.Windows. Forms  46,  89,  1 1 1 
System. Windows. Forms.Control  576 
System  namespace,  Math  class  66 

T 

Tab  Control  207 
Table  grid  28 
tables 

adding  columns  20 
adding  to  database  20 
finish  building  25 
multiple  26 
saving  25 

versus  collections  66 1 
Take  statement  664 
testing  installation  39 
Textbox  control  89 
Text  property  5 1 
changing  34 

The  Problem  Up  Close,  recalculating  new 
individual  costs  183 
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this  keyword  201,  274 

labs,  #  1  A  Day  at  the  Races  1 67 
using  to  raise  event  49 1 
this  variable  154 
Timer  579 
timer  575,  583 
disposing  577 
timers  546,  548 

events  and  delegates  547 
Title  property  399 
Toolbox  components  708-709 
B  ackground Worker  708 
FileSystemWatcher  709 
PerformanceCounter  709 
Toolbox  controls,  easier  way  to  build  578 
ToString( )  method  130,  179 
TrackBars  to  zoom  an  image  in  and  out  603—604 
try/finally  block  473 
try  blocks  455,457 

following  in  debugger  458—459 
turns  versus  frames  549 
types 

object  125 

(see  also  value  types) 

TJ 

uint  type  1 24 
ulong  type  124 
unexpected  input  456 
unhandled  exceptions  452 
versus  exceptions  462 
Unicode  424,  434 

converting  text  to  425 
unique  IDs  20 
unwanted  code  from  IDE  1 1 
upcasting  267,  269 

but  not  downcasting  270 


Up  Close,  access  modifiers  274—275 
uppercasing  201 
user’s  needs  5 
UserControl  578,  606 
user  interface  3 
developing  1 2 
ushort  type  124 
using  keyword,  graphics  606 
using  lines  52 
using  statements  406,473 
Dispose( )  630 
exception  handling  471 

V 

values  versus  references  638 
value  types  124,154 
bool  (see  bool  type) 
byte  (see  byte  type) 
casting  128—130 
changing  154 
char  (see  char  type) 
decimal  (see  decimal  type) 
double  (see  double  type) 
float  (see  float  type) 
int  (see  int  type) 
long  (see  long  type) 
sbyte  124 

short  (see  short  type) 
string  (see  string  type) 
uint  124 
ulong  124 
ushort  124 

variables  matching  types  of  parameters  131 
variables  62,  73,  126 
adding  to  form  112 
assigning  128 
assigning  values  63 
declaring  66 

matching  types  of  parameters  131 
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variables  ( continued) 
naming  136 

reference  (see  reference  variables) 
value  types  (see  types) 
var  keyword  658 
vertical  bars  410 
virtual  keyword  226 
virtual  machines  47,  153 
virtual  methods  231 
visual  components  576 
visual  display  elements  570 
Visual  Studio,  what  you  get  with  C#  and  2 
Visual  Studio  2008,  new  projects  1 1 
Visual  Studio  2008  Express  1 1 
downloading  xxxvi 
setting  up  xxxvi 

Visual  Studio  Integrated  Development  Environment  (see 

IDE) 

void  method 

interfaces  258 
public  259 

void  return  type  88,  103,  113 

w 

Watch  it! 

=  operator  versus  ==  operator  67 
automatic  properties  195 
destructors  and  finalizers  628 
event  handlers,  hooking  up  498 
exceptions  in  constructors  459 
LINQ.  658 
LINQ  queries  663 

method’s  parameter  has  same  name  as  a  field  1 98 
object  initializers  115 


raising  events  with  no  handlers  490 
SerializationException  454 
Server  Explorer  versus  Database  Explorer  18 
things  looking  different  in  your  IDE  8 
writing  to  hies  429 
where  clause  664 
while  loops  65,  69,  73 
white  space  66 
Windows  calculator  125 
Windows  Forms  Application  project  44,  66 
Windows  installer  7 

Windows  Presentation  Framework  (WPF)  7 1 2—7 1 3 
Write( )  method  40 1 
WriteLine( )  method  40 1 

X 

XAML  (Extensible  Application  Markup  Language)  713 
XML,  LINQ, to  XML  704-705 
reading  RSS  feed  705 

Y 

yesNo  =  64 
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zooming;,  TrackBars  to  zoom  an  imag;e  in  and  out 
603-604 

Zoo  Simulator  project  216—222 
class  hierarchy  220 
extending  base  class  221 
inheriting  from  base  class  221 
overriding  methods  2 1 8 
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